@Scheduled注解参数
1、cron参数
这个参数是最经常使用的参数,表示接收一个cron参数,cron它是一个表达式,最多接收7个参数,从左到右分别表示:秒 分 时 日 月 周 年;参数以空格隔开,其中年不是必须参数,可以省略。
注意!!! 在使用时需要在类上添加注解@EnableScheduling,表示开启定时任务。
cron参数意义:
序号 | 名称 | 是否必填 | 范围 | 可选值 |
---|---|---|---|---|
1 | 秒 | 是 | 0-59 | , - * / |
2 | 分 | 是 | 0-59 | , - * / |
3 | 时 | 是 | 0-23 | , - * / |
4 | 日 | 是 | 1-31 | , - * ? / L W C |
5 | 月 | 是 | 1-12 | , - * / |
6 | 周 | 是 | 1-7 | , - * ? / L C # |
7 | 年 | 否 | 1970-2099 | , - * / |
常用通配符:
*:表示所有值 比如用在日 表示每一天。
?:表示不指定值 比如周配置 表示不指定星期几执行。
/:表示起始时间开始触发,然后每隔固定时间触发一次。例如在Minutes域使用5/20,则意味着5分钟触发一次,而25,45等分别触发一次。
,:表示列出枚举值。例如:在Minutes域使用5,20,则意味着在5和20分每分钟触发一次。
-:表示范围。例如在Minutes域使用5-20,表示从5分到20分钟每分钟触发一次。
L:表示最后,只能出现在DayofWeek和DayofMonth域。如果在DayofWeek域使用5L,意味着在最后的一个星期四触发。
W:表示有效工作日(周一到周五),只能出现在DayofMonth域,系统将在离指定日期的最近的有效工作日触发事件。例如:在 DayofMonth使用5W,如果5日是星期六,则将在最近的工作日:星期五,即4日触发。如果5日是星期天,则在6日(周一)触发;如果5日在星期一到星期五中的一天,则就在5日触发。另外一点,W的最近寻找不会跨过月份 。
LW:这两个字符可以连用,表示在某个月最后一个工作日,即最后一个星期五。
#:用于确定每个月第几个星期几,只能出现在DayofMonth域。例如在4#2,表示某月的第二个星期三。
示例:
2、fixedDelay
fixedDelay表示上次调用结束后与下次调用之间的固定时间,单位是毫秒。
@Scheduled(fixedDelay = 1000)
上一个任务结束到下一个任务开始的时间间隔为固定的1秒,任务的执行总是要先等到上一个任务的执行结束
3、fixedRate
fixedRate表示多久执行一次,单位是毫秒。与cron的/通配符用法相似;
@Scheduled(fixedRate = 1000)
每间隔1秒钟就会执行任务(如果任务执行的时间超过1秒,则下一个任务在上一个任务结束之后立即执行)
4、initialDelay
表示第一次延迟多少毫秒执行,单位是毫秒
@Scheduled(initialDelay= 3000)
表示第一次执行时,延迟3秒执行