说起 cron 表达式大家一定不陌生,我们常用来作为定时任务执行策略规则。 在 Spring Boot 框架中 cron 表达式主要配合 @Scheduled 注解在应用程序中使用。 在 Spring Boot 2.4 (既 Spring 5.3)以后,引入了 CronExpression
表达式处理器来替代原有的 CronSequenceGenerator。
为什么要替代原有的 CronSequenceGenerator ? 此处理器是基于 java.util.Calendar
局限性比较大,无法完成last day of month
语义。
- 例如利用CronExpression 计算表达式下次执行时间
LocalDateTime now = LocalDateTime.now();
System.out.println("当前运行时间: " + now);
// 每小时执行一次
CronExpression expression1 = CronExpression.parse("0 0 0/1 * * *");
LocalDateTime nextTime = expression1.next(now);
System.out.println("每小时执行一次 -> 下次执行时间: " + nextTime);
// 每小时第十分执行一次
CronExpression expression2 = CronExpression.parse("0 10 0/1 * * *");
LocalDateTime nextTime2 = expression2.next(now);
System.out.println("每小时第十分执行 -> 下次执行时间: " + nextTime2);
- 执行结果
当前运行时间: 2020-11-14T23:04:46.302739
每小时执行一次 -> 下次执行时间: 2020-11-15T00:00
每小时第十分执行 -> 下次执行时间: 2020-11-14T23:10
新增常用表达式通用宏
对于非开发人员来说 cron 表达式并不容易理解,所以很难在出现错误的时候进行修复。比如笔者会把 cron 表达式 在在线网站 模拟运行一下,确认执行过程方便排查问题。
为了提高可读性,Spring Boot 现在支持以下代表常用表达式的宏。可以使用这些宏而不是六位的表达式,因此:
@Scheduled(cron = "@hourly")。
相当于
@Scheduled(cron = "0 0 * * * *")
其他常用宏命令
宏 | cron 表达式 | 含义 |
---|---|---|
@yearly | 0 0 0 1 1 * | 每年执行一次 |
@monthly | 0 0 0 1 * * | 每月执行一次 |
@weekly | 0 0 0 * * 0 | 每周执行一次 |
@daily 或@annually | 0 0 0 * * * | 每天执行一次 |
@hourly | 0 0 * * * * | 每小时执行一次 |
增强原有表达式 最后几天
每周的第几天
|
∨
* * * * * *
^
|
每月的第几天
如上其中的 每月的第几天
、每周的第几天
支持 最后几天 (L) 的语义
例如:
0 0 0 L * * 每月最后一天的零时
0 0 0 L-3 * * 每月最后第三天的零时 (L-d 格式)
0 0 0 * * 5L 每月最后的星期五零时 (dL 格式)
0 0 0 * * FRIL 每月最后的星期五零时 ( (星期一星期天的英文缩写)L 格式)
增强原有表达式 工作日
* * * * * *
^
|
每月的第几天
如上其中的 每月的第几天
支持 工作日 (W)的语义
例如:
0 0 0 1W * * 每月的第一个工作日零时
0 0 0 LW * * 每月的最后一个工作日零时
增强原有表达式 几周的星期几
每周的第几天
|
∨
* * * * * *
如上其中的 每周的第几天
支持 每月第几周的第几天语义
例如
0 0 0 ? * 5#2 每月第二周的星期五零时
0 0 0 ? * MON#1 每月周一的星期一零时