「Spring Boot 2.4 新特性」新增通用宏简化Cron表达式

原创
2020/11/17 09:25
阅读数 8.8K

说起 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 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    每月周一的星期一零时

项目推荐: Spring Cloud 、Spring Security OAuth2的RBAC权限管理系统 欢迎关注

展开阅读全文
打赏
2
3 收藏
分享
加载中
cron上是越来越好用了
2020/11/18 16:23
回复
举报
有一个问题,比如每天执行一次,quartz cron是0 0 * * * ?,但是作者写的是0 0 0 * * *,我想知道springboot默认自己弄了一套cron表达式规则,还是作者写的有问题?我试过好几个在线网站,都无法解析作者写的这个cron表达式。
2020/11/17 14:27
回复
举报
冷冷zz博主
该评论暂时无法显示,详情咨询 QQ 群:912889742
好吧我上面说错了,是每小时,我测试了下0 0 * * * ?和0 0 * * * *是一样的结果,感谢。前面那种写法quartz兼容,后面这种写法只有spring cron识别。
2020/11/17 18:58
回复
举报
@annually 是一年一次,你写错了。
2020/11/17 10:17
回复
举报
冷冷zz博主
感谢 已修正 排版有问题
2020/11/17 12:36
回复
举报
更多评论
打赏
6 评论
3 收藏
2
分享
返回顶部
顶部