SpringBoot之@Scheduled注解用法解讀
SpringBoot之@Scheduled注解用法
@Scheduled 是 Spring Framework 中用于實(shí)現(xiàn)定時(shí)任務(wù)的核心注解,能夠方便地配置方法在特定時(shí)間或周期執(zhí)行。
以下是詳細(xì)解析:
1. 啟用定時(shí)任務(wù)
在 Spring Boot 中,需在配置類添加 @EnableScheduling 注解以啟用定時(shí)任務(wù)支持:
@Configuration @EnableScheduling public class AppConfig { }
2. 基本用法
直接在方法上添加 @Scheduled
注解,并配置執(zhí)行規(guī)則:
@Component public class ScheduledTasks { // 固定延遲(任務(wù)結(jié)束后的間隔) @Scheduled(fixedDelay = 5000) public void taskWithFixedDelay() { // 每隔5秒執(zhí)行一次(任務(wù)完成后開始計(jì)時(shí)) } // 固定速率(任務(wù)開始的間隔) @Scheduled(fixedRate = 3000) public void taskWithFixedRate() { // 每隔3秒執(zhí)行一次(任務(wù)開始后開始計(jì)時(shí)) } // 初始延遲(首次執(zhí)行前的等待時(shí)間) @Scheduled(initialDelay = 10000, fixedRate = 5000) public void taskWithInitialDelay() { // 首次延遲10秒,之后每隔5秒執(zhí)行一次 } // Cron表達(dá)式(復(fù)雜時(shí)間規(guī)則) @Scheduled(cron = "0 0 12 * * ?") public void taskWithCronExpression() { // 每天中午12點(diǎn)執(zhí)行 } }
3. 參數(shù)詳解
(1) fixedDelay
- 作用:任務(wù)結(jié)束后的固定延遲時(shí)間(單位:毫秒)。
- 示例:@Scheduled(fixedDelay = 5000) 表示任務(wù)結(jié)束后等待5秒再執(zhí)行下一次。
- 適用場(chǎng)景:需確保前一次任務(wù)完成后再執(zhí)行下一次。
(2) fixedRate
- 作用:任務(wù)開始的固定時(shí)間間隔(單位:毫秒)。
- 示例:@Scheduled(fixedRate = 3000) 表示每隔3秒執(zhí)行一次(無論前一次任務(wù)是否完成)。
- 注意:若任務(wù)執(zhí)行時(shí)間超過間隔時(shí)間,可能導(dǎo)致任務(wù)重疊(需結(jié)合線程池配置)。
(3) initialDelay
- 作用:首次任務(wù)執(zhí)行前的初始延遲時(shí)間(單位:毫秒)。
- 示例:@Scheduled(initialDelay = 10000, fixedRate = 5000) 表示首次延遲10秒后執(zhí)行,之后每隔5秒執(zhí)行一次。
(4) cron
- 作用:通過 Cron 表達(dá)式定義復(fù)雜調(diào)度規(guī)則。
- Cron 表達(dá)式格式:秒 分 時(shí) 日 月 周 年(可選)
- 常用示例:
- 0 0 10 * * ?:每天上午10點(diǎn)執(zhí)行。
- 0 0/5 14 * * ?:每天下午2點(diǎn)開始,每隔5分鐘執(zhí)行一次。
- 0 15 10 ? * MON-FRI:每周一至周五上午10:15執(zhí)行。
- 在線工具:推薦使用 Cron表達(dá)式生成器。
4. 線程池配置
默認(rèn)情況下,定時(shí)任務(wù)使用單線程執(zhí)行。若任務(wù)耗時(shí)較長(zhǎng),需配置線程池避免阻塞:
@Configuration public class SchedulerConfig implements SchedulingConfigurer { @Override public void configureTasks(ScheduledTaskRegistrar taskRegistrar) { taskRegistrar.setScheduler(taskExecutor()); } @Bean(destroyMethod = "shutdown") public Executor taskExecutor() { return Executors.newScheduledThreadPool(10); // 自定義線程數(shù) } }
5. 注意事項(xiàng)
1. 避免長(zhǎng)時(shí)間阻塞:若任務(wù)執(zhí)行時(shí)間超過調(diào)度間隔,需合理設(shè)計(jì)邏輯或配置線程池。
2. 分布式環(huán)境問題:在集群中,定時(shí)任務(wù)可能被多個(gè)實(shí)例重復(fù)執(zhí)行。解決方案:
- 使用分布式鎖(如 Redis 或 ZooKeeper)。
- 通過數(shù)據(jù)庫唯一標(biāo)識(shí)控制任務(wù)執(zhí)行。
3. 動(dòng)態(tài)調(diào)整:默認(rèn) @Scheduled 參數(shù)不支持動(dòng)態(tài)修改。如需動(dòng)態(tài)調(diào)度,可結(jié)合 ScheduledTaskRegistrar 或使用 Quartz 框架。
6. 常見問題
Q1:Cron 表達(dá)式中的 ? 和 * 有什么區(qū)別?
*
表示任意值(如:*
在“日”字段表示每天)。?
用于“日”和“周”字段的互斥條件(避免沖突)。
Q2:如何避免任務(wù)重復(fù)執(zhí)行?
- 單機(jī)環(huán)境:確保任務(wù)冪等性。
- 分布式環(huán)境:使用分布式鎖或數(shù)據(jù)庫唯一約束。
Q3:如何調(diào)試定時(shí)任務(wù)?
- 開啟 Spring 的調(diào)試日志:logging.level.org.springframework.scheduling=DEBUG
總結(jié)
@Scheduled 是 Spring 中實(shí)現(xiàn)定時(shí)任務(wù)的便捷工具,通過靈活配置 fixedDelay、fixedRate 或 cron 表達(dá)式,可以滿足大多數(shù)調(diào)度需求。
在復(fù)雜場(chǎng)景(如動(dòng)態(tài)任務(wù)或分布式環(huán)境)中,可結(jié)合 Quartz 或其他分布式調(diào)度框架實(shí)現(xiàn)更高級(jí)功能。
以上為個(gè)人經(jīng)驗(yàn),希望能給大家一個(gè)參考,也希望大家多多支持腳本之家。
相關(guān)文章
Java數(shù)據(jù)結(jié)構(gòu)超詳細(xì)分析二叉搜索樹
二叉搜索樹是以一棵二叉樹來組織的。每個(gè)節(jié)點(diǎn)是一個(gè)對(duì)象,包含的屬性有l(wèi)eft,right,p和key,其中,left指向該節(jié)點(diǎn)的左孩子,right指向該節(jié)點(diǎn)的右孩子,p指向該節(jié)點(diǎn)的父節(jié)點(diǎn),key是它的值2022-03-03java實(shí)現(xiàn)文件上傳、下載、圖片預(yù)覽
這篇文章主要介紹了java實(shí)現(xiàn)文件上傳、下載、圖片預(yù)覽,文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2020-01-01JVM?運(yùn)行時(shí)數(shù)據(jù)區(qū)與JMM?內(nèi)存模型
這篇文章主要介紹了JVM?運(yùn)行時(shí)數(shù)據(jù)區(qū)與JMM?內(nèi)存模型,文章圍繞主題展開詳細(xì)的內(nèi)容介紹,具有一定的參考價(jià)值。需要的朋友可以參考一下2022-07-07老生常談Java虛擬機(jī)垃圾回收機(jī)制(必看篇)
下面小編就為大家?guī)硪黄仙U凧ava虛擬機(jī)垃圾回收機(jī)制(必看篇)。小編覺得挺不錯(cuò)的,現(xiàn)在就分享給大家,也給大家做個(gè)參考。一起跟隨小編過來看看吧2017-08-08SpringBoot靜態(tài)資源CSS等修改后再運(yùn)行無效的解決
這篇文章主要介紹了SpringBoot靜態(tài)資源CSS等修改后再運(yùn)行無效的解決方案,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2021-12-12