目录
平时开发中会遇到关于定时调度的开发任务,定时调度其实有很多的第三方平台可以接入,但其实在SpringBoot中就有自带的定时任务注解@Scheduled可以实现。@Scheduled可以通过注解配置快速实现方法的定时调度,直接在方法加上@Scheduled注解即可。
一、 @Scheduled注解参数
1.cron参数
这个参数是最经常使用的参数,表示接收一个cron参数,cron它是一个表达式,最多接收7个参数,从左到右分别表示:秒 分 时 天 月 周 年;参数以空格隔开,其中年不是必须参数,可以省略。
/**
* cron 一共可以有7个参数 以空格分开 其中年不是必须参数
* [秒] [分] [小时] [日] [月] [周] [年]
* 一下表示
*/
@Scheduled(cron ="0 0 0 * * * ?")
public void testScheduledCron(){
}
PS:在使用时需要在启动类上添加注解@EnableScheduling,表示开启定时任务。
cron参数意义:
序号 | 含义 | 是否必填 | 入参范围 | 可填通配符 |
1 | 秒 | 是 | 0 ~ 59 | , - * / |
2 | 分 | 是 | 0 ~ 59 | , - * / |
3 | 时 | 是 | 0 ~ 23 | , - * / |
4 | 日 | 是 | 1 ~ 31 | , - * ? / L W |
5 | 月 | 是 | 1 ~ 12 | , - * / |
6 | 周(周一 ~ 周日) | 是 | 1 ~ 7 | , - * ? / L # |
7 | 年 | 否 | 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
表示第一次延迟多少毫秒执行,单位是毫秒
# 第一次执行时,延迟3秒执行
@Scheduled(initialDelay= 3000)
8.initialDelayString
initialDelay的升级,支持占位符。
二、注意项
@Scheduled
使用时,是在本机进行任务调度,但是目前几乎所有的应用为了增加发负载量,都是使用多机部署。这就导致了一个非常严重的分布式问题:在每一台机器上都会在同时执行定时调度任务,可能产生很多重复数据或者导致系统出现其他的业务逻辑BUG,所以在使用@Scheduled
进行任务调度时,一定要配合redis的分布式锁来使用,让定时调度任务只在一台机器上执行,避免BUG出现。同时对于可能出现的失败任务一定要做好日志记录,方便排查和修改。
如果这篇文章对您有所帮助,或者有所启发的话,求一键三连:点赞、评论、收藏➕关注,您的支持是我坚持写作最大的动力。