Springboot整合定时任务-CFANZ编程社区

1、基本使用

创建boot项目，pom 包里面只需要引入 Spring Boot Starter 包即可

<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>2.0.0</version>
 </dependency>

在启动类上面加上 @EnableScheduling即可开启任务调度

@SpringBootApplication
@EnableScheduling
public class SysoaApplication {

    public static void main(String[] args) {
        SpringApplication.run(SysoaApplication.class, args);
    }

}

模拟一个定时任务类

@Configuration
public class Task {
    //直接写在注解内
    @Scheduled(fixedRate = 3000)
    public void task1() {
        try {
            System.out.println("任务1执行=" + Thread.currentThread().getName());
            Thread.sleep(5000);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    //配置文件读取执行间隔
    @Scheduled(fixedRateString = "${fixedStr}")
    public void task2() {
        try {
            Thread.sleep(5000);
            System.out.println("任务2执行=" + Thread.currentThread().getName());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

2、相关参数说明

2.1、 @scheduled注解的属性如下

cron：cron表达式，指定任务在特定时间执行；
fixedDelay：表示上一次任务执行完成后多久再次执行，参数类型为long，单位ms；
fixedDelayString：与fixedDelay含义一样，只是参数类型变为String；
fixedRate：表示按一定的频率执行任务，参数类型为long，单位ms；
fixedRateString: 与fixedRate的含义一样，只是将参数类型变为String；
initialDelay：表示延迟多久再第一次执行任务，参数类型为long，单位ms；
initialDelayString：与initialDelay的含义一样，只是将参数类型变为String；
zone：时区，默认为当前时区

2.2、 cron表达式书写规范

Cron表达式是一个由 7个子表达式组成的字符串。每个子表达式都描述了一个单独的日程细节。这些子表达式用空格分隔。

Cron表达式说明：

秒	分	时	日	月	周	年
Seconds	Minutes	Hours	Day-of-Month	Month	Day-of-Week	Year
秒	分钟	小时	月中的天	月	周中的天	年

子表达式说明：

	是否必须	取值范围	特殊字符
秒	是	0-59	, - * /
分	是	0-59	, - * /
时	是	0-23	, - * /
日	是	1-31(需要考虑实际月份)	, - * / ? L W C
月	是	1-12 或 JAN-DEC	, - * /
周	是	1-7 或 SUN-SAT	, - * / ? L C #
年	否	空或 1970-2099	, - * /

汇总：

	1	2	3	4	5	6	7
字段	秒	分	时	日	月	周	年
	Seconds	Minutes	Hours	Day-of-Month	Month	Day-of-Week	Year
	秒	分钟	小时	月中的天	月	周中的天	年
是否必须	是	是	是	是	是	是	否
取值范围	0-59	0-59	0-23	1-31	1-12 或 JAN-DEC	1-7 或 SUN-SAT	空或 1970-2099
特殊字符	, - * /	, - * /	,-*/	, - * / ? L W C	, - * /	, - * / ? L C #	, - * /

注意：Cron表达式对特殊字符的大小写不敏感，对代表星期的缩写英文大小写也不敏感。

特殊字符

*	星号	代表所有可能的值，匹配该域合法的任意值。因此，“ * ”在子表达式【月】里表示每个月的含义，“ * ”在子表达式【周】表示星期的每一天。
?	问号	只能用在日和周域上，但是不能在这两个域上同时使用。表示不指定值。你可以认为 ? 字符是 "我并不关心在该域上是什么值。" 这不同于星号，星号是指示着该域上的每一个值。? 是说不为该域指定值。例如想在每月的20日触发调度，不管20日到底是星期几，则只能使用如下写法： 13 13 15 20 * ?, 其中最后一位只能用？，而不能使用，如果使用表示不管星期几都会触发，实际上并不是这样。
#	井号	该字符只能在星期字段中使用，表示当月某个工作日。如6#3表示当月的第三个星期五(6表示星期五，#3表示当前的第三个)，而4#5表示当月的第五个星期三，假设当月没有第五个星期三，忽略不触发；
/	斜杠	x/y表达一个等步长序列，x为起始值，y为增量步长值。如在分钟字段中使用0/15，则表示为0,15,30和45秒，而5/15在分钟字段中表示5,20,35,50，你也可以使用*/y，它等同于0/y；
-	中划线	表达一个范围，如在小时字段中使用“10-12”，则表示从10到12点，即10,11,12；
,	逗号	表达一个指定的列表值，如在星期字段中使用“MON,WED,FRI”，则表示星期一，星期三和星期五；
L	字母	该字符只在日期和星期字段中使用，代表“Last”的意思，但它在两个字段中意思不同。L在日期字段中，表示这个月份的最后一天，如一月的31号，非闰年二月的28号；如果L用在星期中，则表示星期六，等同于7。但是，如果L出现在星期字段里，而且在前面有一个数值X，则表示“这个月的最后X天”，例如，6L表示该月的最后星期五；
W	字母	该字符只能出现在日期字段里，是对前导日期的修饰，表示离该日期最近的工作日。例如15W表示离该月15号最近的工作日，如果该月15号是星期六，则匹配14号星期五；如果15日是星期日，则匹配16号星期一；如果15号是星期二，那结果就是15号星期二。但必须注意关联的匹配日期不能够跨月，如你指定1W，如果1号是星期六，结果匹配的是3号星期一，而非上个月最后的那天。W字符串只能指定单一日期，而不能指定日期范围。 LW组合：在日期字段可以组合使用LW，它的意思是当月的最后一个工作日；
C	字母	该字符只在日期和星期字段中使用，代表“Calendar”的意思。它的意思是计划所关联的日期，如果日期没有被关联，则相当于日历中所有日期。例如5C在日期字段中就相当于日历5日以后的第一天。1C在星期字段中相当于星期日后的第一天。

示例

30 * * * * ?	每半分钟触发任务
30 10 * * * ?	每小时的10分30秒触发任务
30 10 1 * * ?	每天1点10分30秒触发任务
30 10 1 20 * ?	每月20号1点10分30秒触发任务
30 10 1 20 10 ? *	每年10月20号1点10分30秒触发任务
30 10 1 20 10 ? 2011	2011年10月20号1点10分30秒触发任务
30 10 1 ? 10 * 2011	2011年10月每天1点10分30秒触发任务
30 10 1 ? 10 SUN 2011	2011年10月每周日1点10分30秒触发任务
15,30,45 * * * * ?	每15秒，30秒，45秒时触发任务
15-45 * * * * ?	15到45秒内，每秒都触发任务
15/5 * * * * ?	每分钟的每15秒开始触发，每隔5秒触发一次
15-30/5 * * * * ?	每分钟的15秒到30秒之间开始触发，每隔5秒触发一次
0 0/3 * * * ?	每小时的第0分0秒开始，每三分钟触发一次
0 15 10 ? * MON-FRI	星期一到星期五的10点15分0秒触发任务
0 15 10 L * ?	每个月最后一天的10点15分0秒触发任务
0 15 10 LW * ?	每个月最后一个工作日的10点15分0秒触发任务
0 15 10 ? * 5L	每个月最后一个星期四的10点15分0秒触发任务
0 15 10 ? * 5#3	每个月第三周的星期四的10点15分0秒触发任务

测试地址

http://www.bejson.com/othertools/cron/

2.3、fixedRate 说明

@Scheduled(fixedRate=6000) ：上一次开始执行时间点之后6秒再执行

@Scheduled(fixedDelay=6000) ：上一次执行完毕时间点之后6秒再执行

@Scheduled(initialDelay=1000,fixedRate=6000) ：第一次延迟1秒后执行，之后按 fixedRate 的规则每6秒执行一次

3、多线程执行任务

上面的任务打印出来任务1和任务2都是同一个线程执行的，如何让多个线程执行任务呢？
只需重写接口SchedulingConfigurer 的方法configureTasks

/**
 * 多线程执行定时任务
 */
@Configuration
//所有的定时任务都放在一个线程池中，定时任务启动时使用不同都线程。
public class ScheduleConfig implements SchedulingConfigurer {
    @Override
    public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
        //设定一个长度10的定时任务线程池
        taskRegistrar.setScheduler(Executors.newScheduledThreadPool(10));
    }
}

这样就是多线程执行任务了