SpringBoot整合quartz實(shí)現(xiàn)定時(shí)任務(wù)

更新時(shí)間：2024年10月31日 08:37:43 作者：奮斗

這篇文章主要為大家詳細(xì)介紹了SpringBoot如何整合quartz實(shí)現(xiàn)定時(shí)任務(wù),文中的示例代碼講解詳細(xì),感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下

Quartz基本概念

Quartz是一個(gè)任務(wù)調(diào)度框架，主要用于在特定時(shí)間觸發(fā)任務(wù)執(zhí)行。‌

Quartz的核心概念

‌調(diào)度器（Scheduler）‌：負(fù)責(zé)任務(wù)的調(diào)度和管理，包括任務(wù)的啟動(dòng)、暫停、恢復(fù)等操作。
‌任務(wù)（Job）‌：需要實(shí)現(xiàn)org.quartz.Job接口的execute方法，定義了任務(wù)的具體執(zhí)行邏輯。
‌觸發(fā)器（Trigger）‌：定義任務(wù)執(zhí)行的觸發(fā)條件，包括簡(jiǎn)單觸發(fā)器（SimpleTrigger）和cron觸發(fā)器（CronTrigger）。
‌任務(wù)詳情（JobDetail）‌：用于定義任務(wù)的詳細(xì)信息，如任務(wù)名、組名等。
‌任務(wù)構(gòu)建器（JobBuilder）和觸發(fā)器構(gòu)建器（TriggerBuilder）‌：用于定義和構(gòu)建任務(wù)和觸發(fā)器的實(shí)例。
‌線程池（ThreadPool）‌：用于并行調(diào)度執(zhí)行每個(gè)作業(yè)，提高效率。
‌監(jiān)聽器（Listener）‌：包括任務(wù)監(jiān)聽器、觸發(fā)器監(jiān)聽器和調(diào)度器監(jiān)聽器，用于監(jiān)聽任務(wù)和觸發(fā)器的狀態(tài)變化。

Quartz的基本使用步驟

‌創(chuàng)建任務(wù)類‌：實(shí)現(xiàn)Job接口的execute方法，定義任務(wù)的執(zhí)行邏輯。
‌生成任務(wù)詳情（JobDetail）‌：通過JobBuilder定義任務(wù)的詳細(xì)信息。
‌生成觸發(fā)器（Trigger）‌：通過TriggerBuilder定義任務(wù)的觸發(fā)條件，可以選擇使用簡(jiǎn)單觸發(fā)器或cron觸發(fā)器。
‌獲取調(diào)度器（Scheduler）‌：通過SchedulerFactory創(chuàng)建調(diào)度器對(duì)象，并將任務(wù)和觸發(fā)器綁定在一起，啟動(dòng)調(diào)度器。

Quartz的優(yōu)點(diǎn)和缺點(diǎn)

優(yōu)點(diǎn)‌：支持復(fù)雜的調(diào)度需求，包括定時(shí)、重復(fù)執(zhí)行、并發(fā)執(zhí)行等；提供了豐富的API和工具類，易于使用和維護(hù)；支持Spring集成，方便在Spring項(xiàng)目中應(yīng)用。
‌缺點(diǎn)‌：配置復(fù)雜，需要一定的學(xué)習(xí)成本；對(duì)于簡(jiǎn)單的定時(shí)任務(wù)，使用Quartz可能會(huì)顯得過于復(fù)雜。

整合SpringBoot

第一步：添加依賴

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

第二步：創(chuàng)建scheduler

package com.xy.quartz;

import org.quartz.Scheduler;
import org.quartz.SchedulerException;
import org.quartz.SchedulerFactory;
import org.quartz.impl.StdSchedulerFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class QuartzConfig {
    @Bean
    public Scheduler scheduler() throws SchedulerException {
        SchedulerFactory schedulerFactoryBean = new StdSchedulerFactory();
        return schedulerFactoryBean.getScheduler();
    }
}

第三步：創(chuàng)建Job

import com.songwp.utils.DateUtil;
import lombok.extern.slf4j.Slf4j;
import org.quartz.Job;
import org.quartz.JobDataMap;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;
import org.springframework.stereotype.Component;

import java.util.Date;

@Slf4j
@Component
public class MyJob implements Job {
    @Override
    public void execute(JobExecutionContext jobExecutionContext) throws JobExecutionException {
        JobDataMap jobDataMap = jobExecutionContext.getJobDetail().getJobDataMap();
        log.info("入?yún)?{}", jobDataMap.toString());
        log.info("執(zhí)行定時(shí)任務(wù)的時(shí)間:{}", DateUtil.dateToStr(new Date()));
    }
}

第四步：創(chuàng)建任務(wù)信息類

import lombok.Data;

@Data
public class JobInfo {
    private Long jobId;
    private String cronExpression;
    private String businessId;
}

第五步：創(chuàng)建JobDetail和trigger創(chuàng)建包裝類

import com.songwp.domain.quartz.JobInfo;
import com.songwp.test.MyJob;
import org.quartz.*;
import java.util.Date;

public class QuartzBuilder {
    public static final String RUN_CRON ="定時(shí)執(zhí)行";
    public static final String RUN_ONE ="執(zhí)行一次";
    private static final String JOB_NAME_PREFIX ="flow";
    public static final String TRIGGER_NAME_PREFIX ="trigger.";

    public static JobDetail createJobDetail(JobInfo jobInfo, String type){
        String jobKey =JOB_NAME_PREFIX + jobInfo.getJobId();
        if (RUN_ONE.equals(type)){
            jobKey = JOB_NAME_PREFIX + new Date().getTime();
        }

        return JobBuilder.newJob(MyJob.class)
                .withIdentity(jobKey,"my_group")
                .usingJobData("businessId",jobInfo.getBusinessId())
                .usingJobData("businessType","其他參數(shù)")
                .storeDurably().build();
    }


    public static Trigger createTrigger(JobDetail jobDetail, JobInfo jobInfo){
        return TriggerBuilder.newTrigger()
                .forJob(jobDetail)
                .withIdentity(TRIGGER_NAME_PREFIX + jobInfo.getJobId(),RUN_CRON)
                .withSchedule(CronScheduleBuilder.cronSchedule(jobInfo.getCronExpression()))
                .build();
        }
}

第六步：控制層接口實(shí)現(xiàn)接口

執(zhí)行一次、啟動(dòng)定時(shí)、暫停任務(wù)

import com.songwp.config.quartz.QuartzBuilder;
import com.songwp.domain.quartz.JobInfo;
import lombok.extern.slf4j.Slf4j;
import org.quartz.*;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.annotation.PostConstruct;

@RestController
@Slf4j
public class QuartzController {

    @Autowired
    private Scheduler scheduler;

    /**
     * 定時(shí)任務(wù)執(zhí)行（只執(zhí)行一次）
     * @return
     */
    @GetMapping("runOne")
    public  String runOne(){
        JobInfo jobInfo = new JobInfo();
        jobInfo.setJobId(1L);
        jobInfo.setBusinessId("123");
        jobInfo.setCronExpression("0/5 * * * * ?");
        JobDetail jobDetail = QuartzBuilder.createJobDetail(jobInfo, QuartzBuilder.RUN_ONE);
        Trigger trigger = TriggerBuilder.newTrigger()
                .forJob(jobDetail)
                .startNow()
                .withSchedule(SimpleScheduleBuilder.simpleSchedule().withRepeatCount(0))
                .build();

        try {
            scheduler.scheduleJob(jobDetail, trigger);
            if (!scheduler.isStarted()) {
                scheduler.start();
            }
        } catch (SchedulerException e) {
            log.error(e.getMessage());
            return "執(zhí)行失敗";
        }
        return "執(zhí)行成功";
    }

    /**
     * 開始定時(shí)執(zhí)行
     * @return 執(zhí)行結(jié)果
     */
    @GetMapping("start")
    public String start() {
        try {
            JobInfo jobInfo = new JobInfo();
            jobInfo.setJobId(1L);
            jobInfo.setBusinessId("123");
            jobInfo.setCronExpression("0/5 * * * * ?");
            TriggerKey triggerKey = new TriggerKey(QuartzBuilder.TRIGGER_NAME_PREFIX + jobInfo.getJobId(),QuartzBuilder.RUN_CRON);
            if (scheduler.checkExists(triggerKey)) {
                scheduler.resumeTrigger(triggerKey);
            } else {
                JobDetail jobDetail = QuartzBuilder.createJobDetail(jobInfo, QuartzBuilder.RUN_CRON);
                Trigger trigger = QuartzBuilder.createTrigger(jobDetail, jobInfo);
                scheduler.scheduleJob(jobDetail, trigger);
                if (!scheduler.isStarted()) {
                    scheduler.start();
                }
            }
        } catch (SchedulerException e) {
            log.error(e.getMessage());
            return "執(zhí)行失敗";

        }
        return "執(zhí)行成功";
    }

    /**
     * 停止任務(wù)執(zhí)行
     * @return 執(zhí)行結(jié)果
     */
    @GetMapping("pause")
    public String pause() {
        try {
            JobInfo jobInfo = new JobInfo();
            jobInfo.setJobId(1L);
            jobInfo.setBusinessId("123");
            jobInfo.setCronExpression("0/5 * * * * ?");
            TriggerKey triggerKey = new TriggerKey(QuartzBuilder.TRIGGER_NAME_PREFIX + jobInfo.getJobId(), QuartzBuilder.RUN_CRON);
            if (scheduler.checkExists(triggerKey)) {
                scheduler.pauseTrigger(triggerKey);
            }
        } catch (SchedulerException e) {
            log.error(e.getMessage());
            return "執(zhí)行失敗";
        }
        return "執(zhí)行成功";
    }

    /**
     * 查詢已啟動(dòng)狀態(tài)的任務(wù)，然后重新執(zhí)行
     */
    @PostConstruct
    public void init(){
       log.info("查詢已啟動(dòng)狀態(tài)的任務(wù)，然后重新執(zhí)行");
        start();
    }

}

最后訪問接口：