SpringBoot ~ 定时任务@Scheduled

定时任务@Scheduled

定时任务是企业级开发常见的任务,例如定时统计订单数,数据库备份,定时发送短信和邮件,定时统计博客访客等。简单定时任务通过Spring中的@Schedule注解实现,复杂定时任务可以通过集成Quartz来实现。

  1. 注解说明

    @Scheduled(
        initialDelay = 5000,        //第一次执行前延迟的毫秒数
        initialDelayString = "5000",//同上面作用一样,只是String类型                        
        fixedDelay = 50000,         //在最后一次调用结束和下一次调用开始之间以固定周期(以毫秒为单位)执行带注释的方法。(要等待上次任务完成后)
        fixedDelayString = "50000", //同上面作用一样,只是String类型
        fixedRate = 5000,           //在调用之间以固定的周期(以毫秒为单位)执行带注释的方法。(不需要等待上次任务完成)
        fixedRateString = "5000",   //同上面作用一样,只是String类型
        cron = "",                  //一个类似cron的表达式,扩展了通常的UN * X定义,包括秒,分,时,星期,月,年的触发器。
        zone = ""                   //指明解析cron表达式的时区
    )

    注意:定时任务同步执行时,cron、fixedDelay、fixedRate三者区别如图

    SpringBoot ~ 定时任务@Scheduled

  2. cron表达式

    一个cron表达式可以有6个元素或者7个元素组成(“年”这个元素可以省略,省略之后就是默认“每一年”)

    cron表达式属性如下:

    second(秒), minute(分), hour(时),day of month(日),month(月),day of week(周几),year(1970-2099)

    字段与值表格如下:

    字段 允许值 允许的特殊符号
    0-59 ,-*/
    0-59 ,-*/
    小时 0-23 ,-*/
    日期 1-31 ,-*?/LWC
    月份 1-12 ,-*/
    星期 0-7或SUN-SAT 0 7是SUN ,-*?/LC#
    空, 1970-2099 , - * /

    特殊符号释义如下:

    特殊符号 代表含义
    , 枚举
    - 区间
    * 任意
    / 步长
    ? 日/星期冲突匹配
    L 最后
    W 工作日
    C 和Calendar联系后计算过的值
    # 星期 4#2 第2个星期四

    字符解释

    • 其中每个元素可以是一个值(如6),一个连续区间(9-12),一个间隔时间(8-18/4)(/表示每隔4小时),一个列表(1,3,5),通配符。
    • 其中的“日”由于"月份中的日期"和"星期"这两个元素互斥的,必须要对其中一个设置“?”。
    • 有些子表达式能包含一些范围或列表

      • 例如:子表达式(天(星期))可以为 “MON-FRI”,“MON,WED,FRI”,“MON-WED,SAT”
    • “*”字符代表所有可能的值
    • “/”字符用来指定数值的增量

      • 例如:在子表达式(分钟)里的“0/15”表示从第0分钟开始,每15分钟
      • 在子表达式(分钟)里的“3/20”表示从第3分钟开始,每20分钟(它和“3,23,43”)的含义一样
    • “?”字符仅被用于天(月)和天(星期)两个子表达式,表示不指定值

      • 当2个子表达式其中之一被指定了值以后,为了避免冲突,需要将另一个子表达式的值设为“?”
    • “L” 字符仅被用于天(月)和天(星期)两个子表达式,它是单词“last”的缩写

      • 如果在“L”前有具体的内容,它就具有其他的含义了。例如:“6L”表示这个月的倒数第6天
      • 注意:在使用“L”参数时,不要指定列表或范围,因为这会导致问题
    • “W” 字符代表着平日(Mon-Fri),并且仅能用于日域中。它用来指定离指定日的最近的一个平日。大部分的商业处理都是基于工作周的,所以 W 字符可能是非常重要的。

      • 例如,日域中的 15W 意味着 “离该月15号的最近一个平日。” 假如15号是星期六,那么 trigger 会在14号(星期五)触发,因为星期四比星期一离15号更近。
    • “C”:代表“Calendar”的意思。它的意思是计划所关联的日期,如果日期没有被关联,则相当于日历中所有日期。例如5C在日期字段中就相当于日历5日以后的第一天。1C在星期字段中相当于星期日后的第一天。
  3. cron表达式示例:

    0 0 0 * * * -- 每天零时执行一次
    0 0/15 14,18 * * ? -- 每天14点整和18点整,每隔15分钟执行一次
    0 15 10 ? * 1-6 -- 每个月的周一到周六 10:15分执行一次
    0 0 2 ? * 6L -- 每个月的最后一个周六凌晨2点执行一次
    0 0 2 LW * ? -- 每个月的最后一个工作日凌晨2点执行一次
    0 0 2-4 ? * 1#1 -- 每个月的第一个周一凌晨2点到4点期间,每个整点都执行一次
    
    0 0 10,14,16 * * ?  每天上午10点,下午2点,4点
    0 0/30 9-17 * * ?   朝九晚五工作时间内每半小时
    0 0 12 ? * WED     表示每个星期三中午12点
    0 0 12 * * ?           每天中午12点触发
    0 15 10 ? * *         每天上午10:15触发(这个和下一个案例说明,必须"月份中的日期"和"星期"中有一个设置为“?”)
    0 15 10 * * ?         每天上午10:15触发
    0 15 10 * * ? *       每天上午10:15触发(7个元素类型案例,第七个元素代表年)
    0 15 10 * * ? 2005     2005年的每天上午10:15触发
    0 * 14 * * ?           在每天下午2点到下午2:59期间的每1分钟触发
    0 0/5 14 * * ?       在每天下午2点到下午2:55期间的每5分钟触发
    0 0/5 14,18 * * ?  在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发
    0 0-5 14 * * ?       在每天下午2点到下午2:05期间的每1分钟触发
    0 10,44 14 ? 3 WED      每年三月的星期三的下午2:10和2:44触发
    0 15 10 ? * MON-FRI    周一至周五的上午10:15触发
    0 15 10 15 * ?       每月15日上午10:15触发
    0 15 10 L * ?         每月最后一日的上午10:15触发
    0 15 10 ? * 6L       每月的最后一个星期五上午10:15触发
    0 15 10 ? * 6L 2002-2005    2002年至2005年的每月的最后一个星期五上午10:15触发
    0 15 10 ? * 6#3     每月的第三个星期五上午10:15触发
上一篇:SpringBoot ~ 应用监控


下一篇:SpringBoot ~ 邮件发送