@Scheduled注解参数
- cron参数
这个参数是最经常使用的参数,表示接收一个cron参数,cron它是一个表达式,最多接收7个参数,从左到右分别表示:秒 分 时 天 月 周 年;参数以空格隔开,其中年不是必须参数,可以省略。
/**
* cron 一共可以有7个参数 以空格分开 其中年不是必须参数
* [秒] [分] [小时] [日] [月] [周] [年]
* 一下表示
*/
@Scheduled(cron ="0 0 0 * * * ?")
public void testScheduledCron(){
}
注意!!!在使用时需要在类上添加注解@EnableScheduling,表示开启定时任务。
- cron参数意义:
- 常用通配符:
-
*:表示所有值 比如用在日 表示每一天。
-
?:表示不指定值 比如周配置 表示不指定星期几执行。
-
/:表示递增触发 比如 用在分 5/20 从第五分钟开始 每增加20分钟执行一次。
-
-:表示区间 比如用在 1-6 表示一月到六月执行。
- 示例:
每天凌晨零点执行
@Scheduled(cron ="0 0 0 * * * ?")
每隔五分钟执行
@Scheduled(cron ="0 */5 0 * * * ?")
-
zone参数
zone能够指定获取的时区,默认是空,表示使用服务器所在时区,比如Asia/BeiJingi或者Asia/Shanghai。 -
fixedDelay
fixedDelay表示上次调用结束后与下次调用之间的固定时间,单位是毫秒。
表示距离上次调用后三秒再执行
@Scheduled(fixedDelay= 3000)
-
fixedDelayString
fixedDelayString与fixedDelay是几乎一样的,唯一的差异是fixedDelayString是支持占位符的。 -
fixedRate
fixedRate表示多久执行一次,单位是毫秒。与cron的/通配符用法相似;
表示每三秒执行一次
@Scheduled(fixedRate= 3000)
-
fixedRateString
fixedRate的升级,支持占位符 -
initialDelay
表示第一次延迟多少毫秒执行,单位是毫秒
表示第一次执行时,延迟3秒执行
@Scheduled(initialDelay= 3000)
- initialDelayString
initialDelay的升级,支持占位符。
注意:@Scheduled使用时,是在本机进行任务调度,但是目前几乎所有的应用为了增加发负载量,都是使用多机部署。这就导致了一个非常严重的分布式问题:在每一台机器上都会在同时执行定时调度任务,可能产生很多重复数据或者导致系统出现其他的业务逻辑BUG,所以在使用@Scheduled进行任务调度时,一定要配合redis的分布式锁来使用,让定时调度任务只在一台机器上执行,避免BUG出现。同时对于可能出现的失败任务一定要做好日志记录,方便排查和改错哟~