( 十九 )SpringBoot中 使用定时任务
( 十九 )SpringBoot中 使用定时任务
1、简介
实现定时任务有多中方式:
1、Spring 自带的定时任务处理器 @Scheduled 注解。
2、另一种就是使用第三方框架 Quartz 。
3、使用 xxl-job(推荐)。
2、方式一 @Scheduled
2.1、使用 @Scheduled 非常容易,直接创建一个 SpringBoot 项目,并且添加 web 依赖 spring-boot-starter-web
,项目创建成功后,启动类添加 @EnableScheduling
注解,开启定时任务:
@SpringBootApplication
@EnableScheduling
public class SpringBootStudyApplication {
public static void main(String[] args) {
SpringApplication.run(SpringBootStudyApplication.class, args);
}
}
2.2、接下来配置定时任务:
@Component
public class MyScheduling {
@Scheduled(fixedRate = 2000)
public void fixedRate() {
System.out.println("定时任务 fixedRate>>>" + new Date());
}
}
2.3、@Scheduled 参数说明
- cron 任务执行的cron表达式 。格式: [秒] [分] [小时] [日] [月] [周] [年]。 eg: 0/1 * * * * ?
- zone cron表达时解析使用的时区,默认为服务器的本地时区,使用java.util.TimeZone#getTimeZone(String)方法解析。 eg: GMT-8:00
- fixedDelay 上一次任务执行结束到下一次执行开始的间隔时间,单位为ms 。eg 1秒: 1000
- fixedDelayString 上一次任务执行结束到下一次执行开始的间隔时间,使用java.time.Duration#parse解析。eg: PT15M
- fixedRate 以固定间隔执行任务,即上一次任务执行开始到下一次执行开始的间隔时间,单位为ms,若在调度任务执行时,上一次任务还未执行完毕,会加入worker队列,等待上一次执行完成后立即执行下一次任务。eg 2秒: 2000
- fixedRateString 与fixedRate逻辑一致,只是使用java.time.Duration#parse解析。eg: PT15M
- initialDelay 首次任务执行的延迟时间 。eg: 1000
- initialDelayString 首次任务执行的延迟时间,使用java.time.Duration#parse解。
3、cron具体取值如下:
格式:[秒] [分] [小时] [日] [月] [周] [年]
序号 | 说明 | 是否必填 | 允许填写的值 | 允许的通配符 |
---|---|---|---|---|
1 | 秒 | 是 | 0-59 | - * / |
2 | 分 | 是 | 0-59 | - * / |
3 | 时 | 是 | 0-23 | - * / |
4 | 日 | 是 | 1-31 | - * ? / L W |
5 | 月 | 是 | 1-12 or JAN-DEC | - * / |
6 | 周 | 是 | 1-7 or SUN-SAT | - * ? / L # |
7 | 年 | 否 | 1970-2099 | - * / |
这一块需要大家注意的是,月份中的日期和星期可能会起冲突,因此在配置时这两个得有一个是 ?
通配符含义:
?
表示不指定值,即不关心某个字段的取值时使用。需要注意的是,月份中的日期和星期可能会起冲突,因此在配置时这两个得有一个是?
*
表示所有值,例如:在秒的字段上设置*
,表示每一秒都会触发,
用来分开多个值,例如在周字段上设置 “MON,WED,FRI” 表示周一,周三和周五触发-
表示区间,例如在秒上设置 “10-12”,表示 10,11,12秒都会触发/
用于递增触发,如在秒上面设置”5/15” 表示从5秒开始,每增15秒触发(5,20,35,50)#
序号(表示每月的第几个周几),例如在周字段上设置”6#3”表示在每月的第三个周六,(用 在母亲节和父亲节再合适不过了)- 周字段的设置,若使用英文字母是不区分大小写的 ,即 MON 与mon相同
L
表示最后的意思。在日字段设置上,表示当月的最后一天(依据当前月份,如果是二月还会自动判断是否是润年), 在周字段上表示星期六,相当于”7”或”SAT”(注意周日算是第一天)。如果在”L”前加上数字,则表示该数据的最后一个。例如在周字段上设置”6L”这样的格式,则表示”本月最后一个星期五”W
表示离指定日期的最近工作日(周一至周五),例如在日字段上设置”15W”,表示离每月15号最近的那个工作日触发。如果15号正好是周六,则找最近的周五(14号)触发, 如果15号是周未,则找最近的下周一(16号)触发,如果15号正好在工作日(周一至周五),则就在该天触发。如果指定格式为 “1W”,它则表示每月1号往后最近的工作日触发。如果1号正是周六,则将在3号下周一触发。(注,”W”前只能设置具体的数字,不允许区间”-“)L
和W
可以一组合使用。如果在日字段上设置”LW”,则表示在本月的最后一个工作日触发(一般指发工资 )
可通过在线生成Cron表达式的工具:http://cron.qqe2.com/ 来生成自己想要的表达式。
常用示例: