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

为了提高可读性,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    每月周一的星期一零时
上一篇:Spring Boot XSS 攻击过滤插件使用


下一篇:「SpringBoot2.4新特性」jar自动瘦身