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