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

2020-11-24 10:44:05 浏览数 (1)

说起 cron 表达式大家一定不陌生,我们常用来作为定时任务执行策略规则。 在 Spring Boot 框架中 cron 表达式主要配合 @Scheduled 注解在应用程序中使用。 在 Spring Boot 2.4 (既 Spring 5.3)以后,引入了 CronExpression 表达式处理器来替代原有的 CronSequenceGenerator。

为什么要替代原有的 CronSequenceGenerator ? 此处理器是基于 java.util.Calendar局限性比较大,无法完成last day of month 语义。

  • 例如利用CronExpression 计算表达式下次执行时间
代码语言:javascript复制
  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);
  • 执行结果
代码语言:javascript复制
当前运行时间: 2020-11-14T23:04:46.302739
每小时执行一次 ->   下次执行时间: 2020-11-15T00:00
每小时第十分执行 -> 下次执行时间: 2020-11-14T23:10

新增常用表达式通用宏

对于非开发人员来说 cron 表达式并不容易理解,所以很难在出现错误的时候进行修复。比如笔者会把 cron 表达式 在在线网站 模拟运行一下,确认执行过程方便排查问题。

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

代码语言:javascript复制
@Scheduled(cron = "@hourly")。

相当于

代码语言:javascript复制
@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 * * * *

每小时执行一次

增强原有表达式 最后几天

代码语言:javascript复制
       每周的第几天
           |
           ∨
 * * * * * *
       ^
       |
    每月的第几天

如上其中的 每月的第几天每周的第几天 支持 最后几天 (L) 的语义 例如:

代码语言:javascript复制
0 0 0 L * *   每月最后一天的零时

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

0 0 0 * * 5L    每月最后的星期五零时  (dL 格式)

0 0 0 * * FRIL  每月最后的星期五零时  ( (星期一星期天的英文缩写)L 格式)

增强原有表达式 工作日

代码语言:javascript复制
 * * * * * *
       ^
       |
    每月的第几天

如上其中的 每月的第几天 支持 工作日 (W)的语义 例如:

代码语言:javascript复制
0 0 0 1W * * 每月的第一个工作日零时
0 0 0 LW * * 每月的最后一个工作日零时

增强原有表达式 几周的星期几

代码语言:javascript复制
       每周的第几天
           |
           ∨
 * * * * * *

如上其中的 每周的第几天 支持 每月第几周的第几天语义 例如

代码语言:javascript复制
0 0 0 ? * 5#2     每月第二周的星期五零时

0 0 0 ? * MON#1    每月周一的星期一零时

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

0 人点赞