百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 文章教程 > 正文

「Spring」Spring的定时任务注解@Scheduled原来如此简单

yund56 2025-05-03 17:00 25 浏览

1 简介

定时任务的实现非常多,JDK的Timer、Spring提供的轻量级的Scheduled TaskQuartZLinux Cron等,还有一些分布式的任务调度框架。本文主要介绍Scheduled Task的使用。

2 方便的4种方式

注解@Scheduled只能用于满足下面两个条件的方法上:

(1)没有返回类型,或者说返回类型为void;

(2)没有参数;

开启Spring的Scheduler非常简单,一个注解@EnableScheduling即可:

@Configuration
@EnableScheduling
public class SchedulingConfig {
}

如果是Springboot应用,则直接在启动类上面加上@EnableScheduling就可以使用了。

2.1 固定延迟fixedDelay

代表下一个任务的开始与上一个任务的结束间隔总是固定的时长,而且总是会等上一个任务完成了,才会开启下一个任务。如果需求是有这样依赖要求的,使用这种模式是非常合适的。代码如下:

@Scheduled(fixedDelay = 1000)
public void fixedDelay() {
 log.info("fixedDelay");
}

参数为1000,代表固定延迟为1000毫秒,即1秒钟,所以输出为:

2019-11-19 21:02:43,977 scheduling-1:fixedDelay 
2019-11-19 21:02:44,981 scheduling-1:fixedDelay 
2019-11-19 21:02:45,983 scheduling-1:fixedDelay 
2019-11-19 21:02:46,984 scheduling-1:fixedDelay 

2.2 固定频率fixedRate

2.2.1 正常情况

定频任务的特性是任务的执行的时间间隔总是一样的。比如每1小时执行一次,就是任务执行开始的时间点的时间间隔为1小时。代码如下:

@Scheduled(fixedRate = 2000)
public void fixedRate() {
 log.info("fixedRate");
}

参数为2000,则每2秒执行一次,输出为:

2019-11-19 21:38:45,073 scheduling-1:fixedRate 
2019-11-19 21:38:47,076 scheduling-1:fixedRate 
2019-11-19 21:38:49,073 scheduling-1:fixedRate 
2019-11-19 21:38:51,075 scheduling-1:fixedRate 

2.2.2 默认单线程

需要注意的是它默认是单线程的,不会并行执行。即使是固定频率,但下一次的任务也必须等到上一次任务执行完毕才会开始。下面这个例子能很好说明:

@Scheduled(fixedRate = 1000)
public void fixedRateLongTimeTask() throws InterruptedException {
 log.info("fixedRateLongTimeTask");
 Thread.sleep(3000);
}

由于任务需要执行3秒才能完成,即使fixedRate设置为1秒,并不能每一秒执行一次,输出如下:

2019-11-19 21:46:00,108 scheduling-1:fixedRateLongTimeTask 
2019-11-19 21:46:03,113 scheduling-1:fixedRateLongTimeTask 
2019-11-19 21:46:06,113 scheduling-1:fixedRateLongTimeTask 
2019-11-19 21:46:09,117 scheduling-1:fixedRateLongTimeTask 

每3次输出一次。

2.2.3 注解@Async来帮你

上述问题有办法解决吗?答案是肯定的,而且非常简单。只需要加一个注解@Async就可以使任务能异步多线程地执行了,代码如下:

@Async
@Scheduled(fixedRate = 1000)
public void fixedRateLongTimeTask() throws InterruptedException {
 log.info("fixedRateLongTimeTask");
 Thread.sleep(3000);
}

通过日志可以看出是每秒执行一次的,即使前面的任务还没有完成。而且线程名不一样,通过多线程来执行,输出结果为:

2019-11-19 21:54:22,261 task-5:fixedRateLongTimeTask 
2019-11-19 21:54:23,257 task-6:fixedRateLongTimeTask 
2019-11-19 21:54:24,257 task-4:fixedRateLongTimeTask 
2019-11-19 21:54:25,257 task-8:fixedRateLongTimeTask 
2019-11-19 21:54:26,259 task-1:fixedRateLongTimeTask 
2019-11-19 21:54:27,262 task-2:fixedRateLongTimeTask 
2019-11-19 21:54:28,260 task-3:fixedRateLongTimeTask 

注意:需要指出的是,需要像@EnableScheduling一样,需要添加配置注解@EnableAsync来打开这个功能开关。另外,如果任务执行时间很长,例如1分钟,情况又不一样。以后再详细介绍@Async的使用吧。

2.3 初始延迟initialDelay

初始延迟是用initialDelay来指定的,它可以延迟第一次任务执行的时间。如下例子的参数为30秒,则在启动30秒后,才开始执行第一次。可以减轻项目启动的负担,也可以为任务执行前准备数据。

@Scheduled(fixedDelay = 1000, initialDelay = 30*1000)
public void fixedDelayWithIntialDelay() {
 log.info("fixedDelayWithIntialDelay");
}

输出如下:

2019-11-19 22:10:02,092 main:Tomcat started on port(s): 443 (http) with context path '' 
2019-11-19 22:10:02,095 main:Started DemoApplication in 1.272 seconds (JVM running for 1.767) 
2019-11-19 22:10:32,063 scheduling-1:fixedDelayWithIntialDelay 
2019-11-19 22:10:33,067 scheduling-1:fixedDelayWithIntialDelay 
2019-11-19 22:10:34,069 scheduling-1:fixedDelayWithIntialDelay 
2019-11-19 22:10:35,069 scheduling-1:fixedDelayWithIntialDelay

可以看出,在项目启动后30秒左右,才开始执行任务。

2.4 Cron表达式

上述提供的功能并不能满足定时任务调度的所有需求,比如需要每个月1号发送短信,每周六做数据分析等。这里Cron表达式就派上用场了。

下面的例子表示每当秒数为06的时候就执行。代码如下:

@Scheduled(cron = "6 * * ? * *")
public void cron() {
 log.info("cron");
}

结果如下:

2019-11-19 22:20:06,003 scheduling-1:cron 
2019-11-19 22:21:06,004 scheduling-1:cron 
2019-11-19 22:22:06,002 scheduling-1:cron 

Cron表达式功能非常强大,网上资料很丰富,这里不展开讲了。

3 参数配置化

之前的例子都将参数写死在代码上了,如果需要更灵活,其实可以用参数来配置。这样需要修改参数的时候,不用修改代码、编译打包再部署了,直接修改配置文件即可。

代码如下:

@Scheduled(cron = "${pkslow.cron}")
public void cronWithConfig() {
 log.info("cronWithConfig");
}

在application.properties配置如下:

pkslow.cron=* * * ? * *

代码1秒执行一次。

4 如果她突然消失了

由于Spring的Scheduler默认是单线程的,这样会存在一个问题,如果某个任务执行卡住了,那就无法继续往下执行了。在日志上表现就是突然消失了。这种情况出现的概率还是不小的,如操作数据库死锁了,http请求timeout为无限等待,还有其它原因的死锁等。

当遇到这种情况,应通过命令jstack pid > pid.ThreadDump.txt获取当前线程情况,然后分析是否真的是卡住了,卡在了哪个环节,然后再分析具体代码。通过设置超时或重试等方法来解决。

5 结论

本文主要介绍了Spring的定时任务注解@Scheduled的使用,讲述了多种方式的使用和配置。它非常方便简洁,对于简单的定时任务足以应对了。

欢迎关注公众号<南瓜慢说>,将持续为你更新...

多读书,多分享;多写作,多整理。

相关推荐

豆包编程能力升级:支持HTML代码实时预览、交互

IT之家3月19日消息,IT之家从豆包官方获悉,豆包宣布AI编程功能迎来三项升级,包括HTML预览、Python运行、生成完整项目。据介绍,目前豆包支持HTML代码实时预览和交互...

1898款游戏!80、90回忆杀,重温旧梦,快速搭建中文DOS游戏服务

本内容来源于@什么值得买APP,观点仅代表作者本人|作者:羊刀仙大家好,我是羊刀仙。本期来介绍一个特别情怀向的游戏项目:chinese-dos-games。这套包含1898款经典中文DOS游戏的合集...

利用 SVG 文件内的 HTML 代码进行网络钓鱼攻击

随着时间的推移,网络钓鱼攻击的技术越来越精妙,旨在欺骗用户并规避安全措施。攻击者会使用欺骗性的URL重定向策略,例如将恶意网站地址附加到看似安全的链接后,在PDF中嵌入链接,以及发送HTML...

aardio + AI 大模型自动编写 Python 代码、网页前端代码的经验与技巧

在AI时代,老式的编程习惯完全被颠覆。原来可能要一大堆插件或工具辛苦堆出来的程序,现在只要把AI调教好了就行。aardio支持调用十几种编程语言,这很适合发挥AI大模型的优势。对于AI...

用AI制作游戏就是如此简单!

很多人不知道如何利用AI提高效率,不知道AI能帮我们做什么,其实可以让我们实现很多自己根本不懂的领域取得直观体验,比如利用DS或者豆包,输入“我想做一个简单的单机俄罗斯方块游戏”,AI会给出phtho...

不会写代码?教你用DeepSeek 三步做出小游戏

如今,借助人工智能技术,哪怕你完全看不懂代码,也能通过DeepSeek制作出属于自己的网页版大鱼吃小鱼游戏。接下来,就为大家详细介绍制作过程。第一步、向DeepSeek描述需求为何要做网页版的...

《暗黑1》被移植成网页游戏 可在浏览器上玩了

《暗黑1》,这款1996年发售的“鼠标杀手”砍杀游戏,现在可以在浏览器上玩了。国外专注暴雪游戏的Rivsoft分享了一个《暗黑1》的共享版本,该版本只包含地下城的头2个地区和三个角色职业中的一个。不...

网页代码过滤 轻松获取专辑目录

通过过滤网页代码,可以将网页上显示不全的长文件名列表完整地提取出来。我有一个含有75个视频文件的《中医诊断学》课件,文件名是以01.RMVB、02.RMVB……75.RMVB这种格式命名的。我希望能找...

IDEA 2021首个大版本发布,Java开发者感动哭了(附新亮点演示)

工欲善其事,必先利其器!就在不久之前,Java领域的开发神器IntelliJIDEA终于迎来2021年的一个重要的大版本更新:IntelliJIDEA2021.1。现如今大量的Java开发者深度...

View Source:在 iOS 上轻松查看网页源代码

在移动互联网时代,移动端的应用和web体验都尤为重要,在PC上有很多web前端工具可以选择,而在移动端貌似就少之又少了,在NEXT出现的ViewSource能帮你在iOS上查看...

当我们《寻找房祖名》,我们能找到什么?

游戏葡萄原创专稿,未经允许请勿转载柯震东,因为在九把刀电影《那些年我们追过的女孩》中饰演男主角柯景腾而走红的台湾影星,在昨天被爆出了和著名演员成龙之子房祖名吸毒被抓的丑闻,一时间相关讨论席卷社交网络。...

多用途游戏娱乐新闻网站HTML5模板

Retnews是一个响应式的HTML新闻,博客,杂志网站模板,可以使用这套前端模板简约很多设计的工作。模板有许多特性适合流行的主题商业、时尚,游戏,娱乐,生活方式、体育、科技、政治、旅行、天气、视频等...

简约好看的个人引导页HTML源码下载

源码介绍一款非常简约好看的个人引导页HTML源码,非常适合个人主页以及个人导航使用,纯HTML不需要数据库,上传服务器即可使用!...

教你如何在微信公共平台上插入小游戏(图文教程)

很多玩微信公共平台的朋友都想在公共平台上面插入几个小游戏,用来跟用户之间互动,这里花生来分享一下如何在微信公共平台上插入游戏,以及如何制作html5微信小游戏。首先是找游戏,总共有三个方法,本人比较倾...

html5重力感应剖析附源码

下面是测试html5重力感应的demohttp://bbs.qietu.com/html/zhongli/http://www.qietu.com/html/f2/qqqianbao/demo2是切图...