@Scheduled使用及详解
- @Scheduled注解:任务自动化调度
- @Scheduled 标记要调度的方法的注解。必须指定 cron,fixedDelay或fixedRate属性之一。
- 该注解共有8个参数
1、fixedDelay:固定延迟
- 延迟执行任务。任务在上个任务完成后达到设置的延时时间就执行。
- @Scheduled(fixedDelay = 5000)
- 此处,任务会在上个任务完成后经过5s再执行。
2、fixedRate:定时执行
- 定时执行。任务间隔规定时间即执行。
- @Scheduled(fixedRate = 5000)
- 此处,任务每隔五秒便会执行一次。
3、cron:自定义规则
- 自定义规则执行。比较复杂,一般用6或7个标识符(非官方叫法,方便区分记忆这么叫的)表示任务的执行规则。
- @Scheduled(cron = “0 0 2 * * ?”)
- 此处的逻辑是每天的凌晨两点开始定时执行任务。
补充: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分运行 |