博主在最近的开发中又遇到了关于定时调度的开发任务,在定时调度其实有很多的第三方平台可以接入,但是其实在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出现。同时对于可能出现的失败任务一定要做好日志记录,方便排查和改错哟~

如有帮助请点赞支持~     感谢阅读~

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐