Java定时任务 @Scheduled

Javaの甘乃迪

已于 2023-12-25 16:10:31 修改

阅读量5.9k

点赞数

文章标签： java 开发语言 spring boot spring cloud 数据库 sql

于 2023-11-03 11:42:45 首次发布

本文链接：https://blog.csdn.net/weixin_42555014/article/details/134197749

版权

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

如果这篇文章对您有所帮助，或者有所启发的话，求一键三连：点赞、评论、收藏➕关注，您的支持是我坚持写作最大的动力。