Spring Boot整合Quartz主要是為了在Spring Boot應(yīng)用中方便地使用Quartz定時(shí)任務(wù)框架。Quartz是一個(gè)開源的Java定時(shí)任務(wù)調(diào)度框架，可以方便地創(chuàng)建、管理和執(zhí)行定時(shí)任務(wù)。而Spring Boot則是一個(gè)基于Spring框架的快速開發(fā)工具，可以簡化Spring應(yīng)用的開發(fā)和部署過程。

Quartz 基礎(chǔ)概念

1. 什么是 Quartz

Quartz 是一款開源的 Java 任務(wù)調(diào)度框架，支持基于 Cron 表達(dá)式、固定間隔、固定時(shí)間點(diǎn)等多種調(diào)度規(guī)則，能實(shí)現(xiàn)任務(wù)的全生命周期管理（創(chuàng)建、暫停、恢復(fù)、刪除等），且支持集群部署和任務(wù)持久化，是 SpringBoot 項(xiàng)目中定時(shí)任務(wù)的首選方案。

2. 核心作用

• 定時(shí)執(zhí)行任務(wù)：如定時(shí)同步數(shù)據(jù)、發(fā)送通知、生成報(bào)表等
• 動(dòng)態(tài)管理任務(wù)：無需重啟應(yīng)用即可調(diào)整任務(wù)狀態(tài)
• 高可用支持：集群模式避免單點(diǎn)故障，持久化防止任務(wù)丟失
• 靈活調(diào)度策略：支持 Cron 表達(dá)式、簡單間隔等多種觸發(fā)方式

3. 核心組件

• Job：任務(wù)執(zhí)行邏輯類（實(shí)現(xiàn) org.quartz.Job 接口）
• JobDetail：任務(wù)元數(shù)據(jù)（名稱、分組、參數(shù)等）
• Trigger：調(diào)度規(guī)則（CronTrigger 基于 Cron 表達(dá)式）
• Scheduler：調(diào)度器（綁定 Job 和 Trigger 并執(zhí)行任務(wù)）

前言

在 Spring Boot 項(xiàng)目中，我們經(jīng)常需要定時(shí)執(zhí)行某些任務(wù)，例如定期清理數(shù)據(jù)庫、同步數(shù)據(jù)、發(fā)送通知等。Quartz 是一個(gè)強(qiáng)大的任務(wù)調(diào)度框架，可以通過 Cron 表達(dá)式 實(shí)現(xiàn)靈活的任務(wù)調(diào)度。本篇文章將介紹如何在 Spring Boot 中集成 Quartz 并使用 Cron 表達(dá)式 進(jìn)行任務(wù)調(diào)度。

1. 添加 Quartz 依賴

在 Spring Boot 項(xiàng)目中，首先需要引入 Quartz 相關(guān)依賴。

如果使用 Maven，在 pom.xml 中添加以下依賴：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-quartz</artifactId>
</dependency>

如果使用 Gradle，則添加：

implementation 'org.springframework.boot:spring-boot-starter-quartz'

2. 創(chuàng)建 Quartz 任務(wù)

在 Quartz 中，每個(gè)定時(shí)任務(wù)需要繼承 org.quartz.Job 接口，并實(shí)現(xiàn) execute 方法。

import org.quartz.Job;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;
import java.time.LocalDateTime;
public class MyQuartzJob implements Job {
    @Override
    public void execute(JobExecutionContext context) throws JobExecutionException {
        System.out.println("Quartz 定時(shí)任務(wù)執(zhí)行中：" + LocalDateTime.now());
    }
}

3. 配置 Quartz 任務(wù)調(diào)度

Spring Boot 允許通過 SchedulerFactoryBean 配置 Quartz 任務(wù)，并使用 @Bean 方式定義任務(wù)的調(diào)度規(guī)則。

import org.quartz.*;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
public class QuartzConfig {
    // 定義 JobDetail
    @Bean
    public JobDetail myJobDetail() {
        return JobBuilder.newJob(MyQuartzJob.class)
                .withIdentity("myQuartzJob")  // 任務(wù)名稱
                .storeDurably()
                .build();
    }
    // 定義觸發(fā)器，使用 Cron 表達(dá)式
    @Bean
    public Trigger myJobTrigger() {
        return TriggerBuilder.newTrigger()
                .forJob(myJobDetail())
                .withIdentity("myQuartzTrigger") // 觸發(fā)器名稱
                .withSchedule(CronScheduleBuilder.cronSchedule("0 0/5 0-7 ? * * *")) // Cron 表達(dá)式
                .build();
    }
}

在上述配置中，我們的定時(shí)任務(wù)：

• 每 5 分鐘執(zhí)行一次
• 每天從 00:00 到 07:59 之間執(zhí)行
• 使用 Cron 表達(dá)式 0 0/5 0-7 ? * * *

如果需要 08:00 也執(zhí)行一次，可以修改 Cron 表達(dá)式為：

0 0/5 0-8 ? * * *

4. 啟動(dòng) Spring Boot 觀察定時(shí)任務(wù)執(zhí)行

啟動(dòng) Spring Boot 項(xiàng)目，觀察控制臺(tái)輸出：

Quartz 定時(shí)任務(wù)執(zhí)行中：2024-03-19T00:00:00
Quartz 定時(shí)任務(wù)執(zhí)行中：2024-03-19T00:05:00
Quartz 定時(shí)任務(wù)執(zhí)行中：2024-03-19T00:10:00
...
Quartz 定時(shí)任務(wù)執(zhí)行中：2024-03-19T07:55:00

如果 Cron 表達(dá)式修改為 0 0/5 0-8 ? * * *，則會(huì)多執(zhí)行一次：

Quartz 定時(shí)任務(wù)執(zhí)行中：2024-03-19T08:00:00

5. Quartz Cron 表達(dá)式詳解

Quartz 的 Cron 表達(dá)式有 7 個(gè)字段，每個(gè)字段的含義如下：

示例 Cron 表達(dá)式：

• 0 0 12 * * ? → 每天中午 12:00 執(zhí)行
• 0 0/30 * * * ? → 每 30 分鐘執(zhí)行一次
• 0 15 10 * * ? → 每天 10:15 執(zhí)行
• 0 0 8-20/2 * * ? → 每天 08:00 - 20:00 之間，每 2 小時(shí)執(zhí)行一次

6. 結(jié)論

本篇文章介紹了如何在 Spring Boot 中集成 Quartz 進(jìn)行定時(shí)任務(wù)調(diào)度，并通過 Cron 表達(dá)式 控制任務(wù)執(zhí)行時(shí)間。Quartz 提供了更強(qiáng)大的任務(wù)調(diào)度能力，比 @Scheduled 注解更靈活，適用于復(fù)雜的定時(shí)任務(wù)需求。

你是否在項(xiàng)目中使用 Quartz？歡迎在評(píng)論區(qū)分享你的經(jīng)驗(yàn)！ ??

生產(chǎn)環(huán)境注意事項(xiàng)

• 配置調(diào)整：
  • 將 spring.quartz.jdbc.initialize-schema 改為 NEVER
  • 關(guān)閉 MyBatis-Plus SQL 日志（刪除 log-impl 配置）
• 集群部署：
  • 開啟 isClustered: true
  • 所有節(jié)點(diǎn)連接同一數(shù)據(jù)庫
  • 確保服務(wù)器時(shí)間同步
• 任務(wù)類規(guī)范：
  • 必須有無參構(gòu)造方法
  • 全路徑在集群環(huán)境中保持一致
• 異常處理：
  • 任務(wù)執(zhí)行類中添加異常捕獲
  • 關(guān)鍵操作記錄日志

到此這篇關(guān)于Spring Boot 集成 Quartz并使用Cron 表達(dá)式實(shí)現(xiàn)定時(shí)任務(wù)的文章就介紹到這了,更多相關(guān)Spring Boot 集成Quartz內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論