注解"/>
浅谈@Scheduled注解
最近项目中一个业务需要做定时任务,我就使用到了@Scheduled注解,问了朋友有不熟悉的,就随便写点入门的东西,稍微讲讲这个注解怎么用,它的参数都是什么意思。
我使用的是springboot开发的项目,不需要额外再做配置,所以直接就单纯的讲下@Scheduled注解。如果是使用的SSM或者SSH等框架的项目,在使用时候需要再spring的xml配置文件进行配置,具体的可以百度使用方法。
使用@Schedule注解主要的还是要搞懂cron表达式的内容表示的都是什么意思,cron表达式里面代表的是执行时机。
Cron表达式由6或7个空格分隔的时间元素组成,按照顺序依次如下表所示:
字段 | 允许值 | 允许的特殊字符 |
秒 | 0~59 | -*/ |
分钟 | 0~59 | -*/ |
小时 | 0~23 | -*/ |
日期 | 0~31 | ,-*?/LWC |
月份 | 0~11 | -*/ |
星期 | 1~7,1为SUN-依次为SUN,MON,TUE,WED,THU,FRI,SAT | ,-*?/LC# |
年(可选) | 留空,1970-2099 | -*/ |
其中每个元素可以是一个值(如6),一个连续区间(9-12),一个间隔时间(8-18/4)(/表示每隔4小时),一个列表(1,3,5),通配符。由于"月份中的日期"和"星期中的日期"这两个元素互斥的,必须要对其中一个设置?。
以下为部分示例:
cron表达式 | 含义 |
"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触发 |
有些子表达式能包含一些范围或列表,例如:
子表达式(天(星期))可以为“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在星期字段中相当于星期日后的第一天。
当然,使用cron表达式是可以定制各种各样的需求,不过如果是简单的一些可以使用简单的定期调度,如:
以下的方法将以一个固定延迟时间5秒钟调用一次执行,这个周期是以上一个调用任务的完成时间为基准,在上一个任务完成之后,5s后再次执行:
@Scheduled(fixedDelay = 5000)
public void doSomething() {// something that should execute periodically
}
如果需要以固定速率执行,只要将注解中指定的属性名称改成fixedRate即可,以下方法将以一个固定速率5s来调用一次执行,这个周期是以上一个任务开始时间为基准,从上一任务开始执行后5s再次调用:
@Scheduled(fixedRate = 5000)
public void doSomething() {// something that should execute periodically
}
更多推荐
浅谈@Scheduled注解
发布评论