在Spring Boot中编写定时任务是非常简单的事,直接使用Scheduled注解就可以完成复杂的定时任务设置.下面是一个10分钟执行定时任务的示例:
@Scheduled(cron = "0 0/10 * * * ?")
private void schedulerEmptyMsg() {
LogUtils.info("定时任务执行:" + System.currentTimeMillis());
}
上面的示例中使用了cron表达式,springboot的定时任务还支持其他方式进行定时周期设置:
@Scheduled(fixedDelay = 5000)//fixedDelay = 5000表示当前方法执行完毕5000ms后,Spring scheduling会再次调用该方法
public void testFixDelay() {
}
@Scheduled(fixedRate = 5000)//fixedRate = 5000表示当前方法开始执行5000ms后,Spring scheduling会再次调用该方法
public void testFixedRate() {
}
@Scheduled(initialDelay = 1000, fixedRate = 5000)//initialDelay = 1000表示延迟1000ms执行第一次任务
public void testInitialDelay() {
}
Scheduled注解支持多种参数:
- zone:时区,默认为当前时区.
- fixedDelay:表示上一次任务执行完成后多久再次执行,参数类型为long,单位ms;
- fixedDelayString:与fixedDelay含义一样,只是参数类型变为String;
- fixedRate:表示按一定的频率执行任务,参数类型为long,单位ms;
- fixedRateString:与fixedRate的含义一样,只是将参数类型变为String;
- initialDelay:表示延迟多久再第一次执行任务,参数类型为long,单位ms;
- initialDelayString:与initialDelay的含义一样,只是将参数类型变为String;
- cron:cron表达式.
Cron表达式:
Cron表达式生成器
Cron表达式是一个字符串,是由空格隔开的6或7个域组成,每一个域对应一个含义(秒 分 时 每月第几天 月 星期 年)其中年是可选字段。
从左到右分别代表: 秒 分 时 日 月 星期 年份
字段 | 允许值 | 允许的字符 |
---|---|---|
秒 | 0-59 | , - * /(0-59的整数) |
分 | 0-59 | , - * /(0-59的整数) |
小时 | 0-23 | , - * /(0-23的整数) |
日期 | 1-31 | , - * ? / L W C(0-31的整数) |
月份 | 1-12 or JAN-DEC | , - * /(1-12的整数或JAN-DEc) |
星期 | 1-7 or SUN-SAT | , - * ? / L C #(1-7的整数或SUN-SAT两个范围。1表示星期天,2表示星期一) |
年 | 1970-2099 | , - * / |
“ * ” 表示所有值 在秒的位置写“ * ”表示每秒
“ ? ” 用来指定“非明确的值”
“-” 表示至,例如日期中“2-5”,指的是2号、3号、4号、5号
“,” 表示和,例如日期中“2,5”,指的是2号和5号
“/” 表示增量,例如上面实现代码中的“0/10”,指的是每隔10秒
"," 表示列出枚举值。例如:在分域使用5,20,则意味着在5和20分时触发一次。
"L" 表示最后,只能出现在星期和每月第几天域,如果在星期域使用1L,意味着在最后的一个星期日触发。
"W" 表示有效工作日(周一到周五),只能出现在每月第几日域,系统将在离指定日期的最近的有效工作日触发事件。注意一点,W的最近寻找不会跨过月份
"LW" 这两个字符可以连用,表示在某个月最后一个工作日,即最后一个星期五。
"#" 用于确定每个月第几个星期几,只能出现在每月第几天域。例如在1#3,表示某月的第三个星期日。
"0 0 * * * *" = 每天的每小时开始时
"*/10 * * * * *" = 每10分钟
"0 0 8-10 * * *" = 每天的8, 9 和 10 点
"0 0 6,19 * * *" = 每天的早上6点和下午7点
"0 0/30 8-10 * * *" = 每天的8:00, 8:30, 9:00, 9:30, 10:00 和 10:30,即8-10点,每半小时一次
"0 0 9-17 * * MON-FRI" = 每周一至周五,9点到17点的0分0秒执行
"0 0 0 25 12 ?" = 每年圣诞节(12月25日)0时0分0秒执行