Spring Boot 2.4 全新Cron表达式处理机制

说起 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 表达式 在在线网站^[1] 模拟运行一下，确认执行过程方便排查问题。

为了提高可读性，Spring Boot 现在支持以下代表常用表达式的宏。可以使用这些宏而不是六位的表达式，因此：

@Scheduled(cron = "@hourly")。

相当于

@Scheduled(cron = "0 0 * * * *")

其他常用宏命令

增强原有表达式 最后几天

       每周的第几天
           |
           ∨
 * * * * * *
       ^
       |
    每月的第几天

如上其中的 每月的第几天、每周的第几天 支持 最后几天 （L） 的语义 例如：

0 0 0 L * *   每月最后一天的零时

0 0 0 L-3 * *   每月最后第三天的零时  (L-d 格式)

0 0 0 L-3 * *   每月最后第三天的零时

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

参考资料