@Scheduled注解

时间:2025-03-18 20:28:46

@Scheduled使用及详解

  • @Scheduled注解:任务自动化调度
  • @Scheduled 标记要调度的方法的注解。必须指定 cronfixedDelayfixedRate属性之一。
  • 该注解共有8个参数

1、fixedDelay:固定延迟

  1. 延迟执行任务。任务在上个任务完成后达到设置的延时时间就执行。
  2. @Scheduled(fixedDelay = 5000)
  3. 此处,任务会在上个任务完成后经过5s再执行。

2、fixedRate:定时执行

  1. 定时执行。任务间隔规定时间即执行。
  2. @Scheduled(fixedRate = 5000)
  3. 此处,任务每隔五秒便会执行一次。

3、cron:自定义规则

  1. 自定义规则执行。比较复杂,一般用6或7个标识符(非官方叫法,方便区分记忆这么叫的)表示任务的执行规则。
  2. @Scheduled(cron = “0 0 2 * * ?”)
  3. 此处的逻辑是每天的凌晨两点开始定时执行任务。

补充:cron 标识符

从左到右用空格隔开分别是:【秒 分 时 日 月 周 年(可省略)

第一个位置:Seconds 秒:区间 0-59 秒,代表一分钟内的秒数。

第二个位置:Minutes 分:区间 0-59 分,代表一小时内的分钟数。

第三个位置:Hours 时:区间 0-23 时,代表一天中的小时数。

第四个位置:Day of month 日:区间 1-31 (?根据每月有多少天来),代表一月中的多少号。

第五个位置:Month 月:区间 1-12 ,代表一年中的月份。

第六个位置:Day of week 周:区间 1-7或者英文星期的缩写,代表星期几。

(注意:1 对应周日 SUN , 7 对应周六 SAT ,如此循环)

第七个位置:Year 年:区间1970-2099,代表具体年份,但是一般不用,可以直接不写。(为什么到了2099年就停了?)

时间域 是否必填 值以及范围 通配符
0-59 , - * /
0-59 , - * /
0-23 , - * /
1-31 , - * ? / L W C
1-12 或 JAN-DEC , - * /
1-7 或 SUN-SAT , - * ? / L C #
1970-2099 , - * /

cron表达式

例1:@scheduled (cron=“0 0 2 2 * ? *”) 表示:每月二号凌晨两点执行。

例2:@scheduled (cron=“15,20,40 15-20 2/5 L * ?”) 表示:每月的最后一天的凌晨2点开始每隔5小时的第15分钟到第20分钟之间的每分钟的第15,20,40秒执行一次。

例3:@scheduled (cron=“0 0 0 15W * ?”) 表示:每月离15号最近的工作日。

例4:@scheduled (cron= "0 0 0 0 * 2#3 ") 表示:每月的第三个周一。

字符描述

写在cron表达式的标识符位置用于表达特定意义的字符,如 例1 中的:0,2,*,?

字符 描述
阿拉伯数字 数值,出现在标识符位置的数字代表对应值,比如第一个2代表两点,第二个2代表二号
* 通配,语义相当于每… 比如第五个位置的 *就表示每月都会执行(相当于1-12)
? 忽略,语义相当于不管… 比如第六个位置的?就表示不管当前是周几就会执行。至于为什么会有这种用法,我觉得应该是因为它和其他的字符可能会冲突。如果用*的话表示周一到周日都会执行,此时其他语义就不明确了,所以如果用不上星期的话一般给它用一个?表示 not care。
/ 间隔,语义相当于每隔… 比如例2中的第三个位置的2/5就表示从2点开始每隔五小时
- 区间,语义相当于第…到…的每… 比如例2中的第二个位置的15-20就表示第15分钟到20分钟之间的每分钟
, 枚举,语义相当于第…和… 比如例2中的第一个位置的15,20,40就表示第15秒、20秒和40秒
L 最后(last),语义相当于最后一个 比如例2中的第四个位置的L就表示最后一天
W 工作日,字面意思,就是工作日 比如例3中的第四个位置的15W表示15号附近最近的工作日,如果15号刚好是工作日那就15号触发,如果15号是周六那就14号触发,如果15号是周日那就16号触发。前面不带数字就是所有匹配的工作日
# 周定位,语义相当于每月的第几个周几 比如例4中的第六个位置的2#3就表示第三个周一

常用示例

表达式 描述
0/5 * * * * ? 每隔5秒执行一次
0 */1 * * * ? 每隔1分钟执行一次
0 0 23 * * ? 每天23点执行一次
0 0 1 * * ? 每天凌晨1点执行一次
0 0 1 1 * ? 每月1号凌晨1点执行一次
0 0 23 L * ? 每月最后一天23点执行一次
0 0 1 ? * L 每周星期天凌晨1点实行一次
0 26,29,33 * * * ? 在26分、29分、33分执行一次
0 0 0,13,18,21 * * ? 每天的0点、13点、18点、21点都执行一次
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触发
“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触发
"0 0 12 * * ? " 每天12点运行
“0 15 10 * * ?” 每天10:15运行
“0 15 10 * * ? 2011” 2011年的每天10:15运行
“0 * 14 * * ?” 每天14点到15点之间每分钟运行一次,开始于14:00,结束于14:59。
“0 0/5 14 * * ?” 每天14点到15点每5分钟运行一次,开始于14:00,结束于14:55。
“0 0/5 14,18 * * ?” 每天14点到15点每5分钟运行一次,此外每天18点到19点每5钟也运行一次。
“0 0-5 14 * * ?” 每天14:00点到14:05,每分钟运行一次。
“0 10,44 14 ? 3 WED” 3月每周三的14:10分到14: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 2007-2009” 在2007,2008,2009年每个月的最后一个星期五的10:15分运行。
“0 15 10 ? * 6#3” 每月第三个星期五的10:15分运行