Spring Boot 使用 @Scheduled 注解創建定時任務
在項目開發中我們經常需要一些定時任務來處理一些特殊的任務,比如定時檢查訂單的狀態、定時同步數據等等。
在 Spring Boot 中使用 @Scheduled 注解創建定時任務非常簡單,只需要兩步操作就可以創建一個定時任務:
1、在定時任務類上增加
@EnableScheduling注解
2、在要執行任務的方法上增加@Scheduled注解
下面是我使用 cron 表達式創建一個簡單的定時任務:
import java.text.SimpleDateFormat;
import java.util.Date;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
@Component
// 啟用定時任務
@EnableScheduling
public class ScheduledTasks {
private static final Logger log = LoggerFactory.getLogger(ScheduledTasks.class);
private static final SimpleDateFormat dateFormat = new SimpleDateFormat("HH:mm:ss");
// 每 5 秒執行一次任務。
@Scheduled(cron = "0/5 * * * * ?")
public void performingTasks() {
log.info("執行定時任務時間:{}", dateFormat.format(new Date()));
}
}
啟動運行項目以后控制臺會每隔五秒打印一條記錄。
2019-07-25 11:12:00.343 INFO 15988 --- [pool-1-thread-1] c.m.s.s.a.controller.ScheduledTasks : 執行定時任務時間:11:12:00
2019-07-25 11:12:05.343 INFO 15988 --- [pool-1-thread-1] c.m.s.s.a.controller.ScheduledTasks : 執行定時任務時間:11:12:05
2019-07-25 11:12:10.343 INFO 15988 --- [pool-1-thread-1] c.m.s.s.a.controller.ScheduledTasks : 執行定時任務時間:11:12:10
2019-07-25 11:12:15.343 INFO 15988 --- [pool-1-thread-1] c.m.s.s.a.controller.ScheduledTasks : 執行定時任務時間:11:12:15
2019-07-25 11:12:20.343 INFO 15988 --- [pool-1-thread-1] c.m.s.s.a.controller.ScheduledTasks : 執行定時任務時間:11:12:20
2019-07-25 11:12:25.342 INFO 15988 --- [pool-1-thread-1] c.m.s.s.a.controller.ScheduledTasks : 執行定時任務時間:11:12:25
一些常用的 Cron 表達式例子
| 表達式 | 說明 |
|---|---|
| 0/2 * * * * ? | 表示每 2 秒執行任務 |
| 0 0/2 * * * ? | 表示每 2 分鐘執行任務 |
| 0 0 2 1 * ? | 表示在每月的 1 日的凌晨 2 點調整任務 |
| 0 15 10 ? * MON-FRI | 表示周一到周五每天上午 10:15 執行作業 |
| 0 15 10 ? 6L 2002-2006 | 表示 2002-2006 年的每個月的最后一個星期五上午 10:15 執行作 |
| 0 0 10,14,16 * * ? | 每天上午 10 點,下午 2 點,4 點 |
| 0 0/30 9-17 * * ? | 朝九晚五工作時間內每半小時 |
| 0 0 12 ? * WED | 表示每個星期三中午 12 點 |
| 0 0 12 * * ? | 每天中午 12 點觸發 |
| 0 15 10 ? * * | 每天上午 10:15 觸發 |
| 0 15 10 * * ? | 每天上午 10:15 觸發 |
| 0 15 10 * * ? | 每天上午 10:15 觸發 |
| 0 15 10 * * ? 2005 | 2005 年的每天上午 10:15 觸發 |
| 0 * 14 * * ? | 在每天下午 2 點到下午 2:59 期間的每 1 分鐘觸發 |
| 0 0/5 14 * * ? | 在每天下午 2 點到下午 2:55 期間的每 5 分鐘觸發 |
| 0 0/5 14,18 * * ? | 在每天下午 2 點到 2:55 期間和下午 6 點到 6:55 期間的每 5 分鐘觸發 |
| 0 0-5 14 * * ? | 在每天下午 2 點到下午 2:05 期間的每 1 分鐘觸發 |
| 0 10,44 14 ? 3 WED | 每年三月的星期三的下午 2:10 和 2:44 觸發 |
| 0 15 10 ? * MON-FRI | 周一至周五的上午 10:15 觸發 |
| 0 15 10 15 * ? | 每月 15 日上午 10:15 觸發 |
| 0 15 10 L * ? | 每月最后一日的上午 10:15 觸發 |
| 0 15 10 ? * 6L | 每月的最后一個星期五上午 10:15 觸發 |
| 0 15 10 ? * 6L 2002-2005 | 2002 年至 2005 年的每月的最后一個星期五上午 10:15 觸發 |
| 0 15 10 ? * 6#3 | 每月的第三個星期五上午 10:15 觸發 |
@Scheduled 除了支持 cron 表達式以外還有很多的其他使用方法:
// 上一次開始執行時間點后 1 秒再次執行。
@Scheduled(fixedRate = 1000)
// 上一次執行完畢時間點后 1 秒再次執行。
@Scheduled(fixedDelay = 1000)
// 第一次延遲 2 秒執行,然后在上一次執行完畢時間點后 1 秒再次執行。
@Scheduled(initialDelay = 2000, fixedDelay = 1000)
網上也有一些 Cron 測試工具可以驗證定時任務的執行時間:
1、https://tool.lu/crontab/
2、http://cron.qqe2.com/

浙公網安備 33010602011771號