SpringBoot教程（二十四） | SpringBoot实现分布式定时任务之Quartz（基础）

简介

Quartz是一个完全由Java开发的开源任务日程管理系统（或称为作业调度框架），它能够集成于任何Java应用，小到独立的应用，大至电子商务系统。
Quartz提供了丰富的调度功能和灵活的配置选项，帮助开发者实现复杂的任务调度和定时任务功能。

适用场景

Quartz广泛应用于各种企业级应用系统中，如电子商务、金融、物流等领域。
无论是简单的定时任务（如定时发送邮件、定时清理临时文件等），还是复杂的分布式任务（如分布式定时任务调度、任务依赖关系管理等），Quartz都能够胜任。

Quartz核心概念

Job（作业）

Quartz中的任务，是一个需要被调度执行的接口，任务类需要实现该接口，并在execute方法中编写具体的业务逻辑。

JobDetail

JobDetail用来绑定Job，并为Job实例提供许多属性，如名称、组名、Job类名以及JobDataMap等。
JobDetail定义的是任务数据，而真正的执行逻辑是在Job中。

Trigger（触发器）

Trigger是Quartz的触发器，它描述了触发Job执行的时间触发规则。
Trigger最常用的触发器类型：SimpleTrigger和CronTrigger。

Scheduler（调度器）

Scheduler是Quartz的调度器，它负责基于Trigger设定的时间执行Job。Scheduler是一个容器，它装载着任务和触发器。

Quartz 存储方式

Quartz 存储方式有两种：MEMORY 和 JDBC。

• MEMORY（或RAMJobStore）：这是Quartz的默认存储方式，它将任务调度的运行信息保存在内存中。这种方式提供了最佳的性能，因为内存中数据访问最快。然而，它的不足之处在于缺乏数据的持久性，当程序中途停止或系统崩溃时，所有运行的信息都会丢失。
• JDBC：这种存储方式允许Quartz通过JDBC将任务调度的运行信息保存到数据库中。使用数据库保存任务调度信息后，即使系统崩溃后重新启动，任务的调度信息也将得到恢复。因此，JDBC存储方式提供了数据的持久性。

Quartz 版本类型

Quartz 版本类型有两种：单机版 和 集群版

• 单机版：这是Quartz的默认版本类型 ，Quartz运行在一个单一的Java虚拟机（JVM）实例中。它通常使用MEMORY存储方式，因为这种方式配置容易且运行速度快。然而，单机版Quartz存在单点故障的风险，如果应用程序所在的服务器出现故障，任务调度将会停止。

• 集群版：集群版Quartz可以在多个JVM实例中运行，实现高可用性和负载均衡。在集群版中，通常使用JDBC存储方式，以便在多个节点之间共享任务调度的数据。这样，即使其中一个节点出现故障，其他节点仍然可以继续工作，从而保证了任务调度的连续性和可靠性。

引入相关依赖

<!--quartz定时任务-->
<dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter-quartz</artifactId>
</dependency>

开始集成

方式一：内存方式(MEMORY)存储实现定时任务

1. 定义任务类

可以通过实现 Job 接口来定义任务，也可以通过继承 QuartzJobBean 这个抽象类来定义任务，其实 QuartzJobBean 本身也实现了 Job 接口，其本质都是实现 Job 接口来定义任务。

我这边定义了两个任务，用于后续来说明一下关于调度器Scheduler绑定的不同方式
Scheduler绑定有两种方式，一种是使用bena的自动配置，一种是Scheduler手动配置。

FirstJob 类

package com.example.springbootfull.quartztest;

import lombok.extern.slf4j.Slf4j;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;
import org.springframework.scheduling.quartz.QuartzJobBean;

import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;

@Slf4j
public class FirstJob extends QuartzJobBean {
   
   

    @Override
    protected void executeInternal(JobExecutionContext jobExecutionContext) throws JobExecutionException {
   
   
        String now = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss").format(LocalDateTime.now());
        log.info("手动-FirstJob, 当前的时间: " + now);
    }
}

SecondJob 类

package com.example.springbootfull.quartztest;

import lombok.extern.slf4j.Slf4j;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;
import org.springframework.scheduling.quartz.QuartzJobBean;

import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;

@Slf4j
public class SecondJob extends QuartzJobBean {
   
   

    @Override
    protected void executeInternal(JobExecutionContext jobExecutionContext) throws JobExecutionException {
   
   
        String now = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss").format(LocalDateTime.now());
        log.info("自动-SecondJob, 当前的时间: " + now);
    }
}

2. 定义任务描述及创建任务触发器

方式一：Scheduler手动配置

这个例子使用的是触发器类型为Cron

package com.example.springbootfull.quartztest.config;

import com.example.springbootfull.quartztest.FirstJob;
import org.quartz.*;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.ApplicationArguments;
import org.springframework.boot.ApplicationRunner;
import org.springframework.stereotype.Component;

@Component
public class JobInit implements ApplicationRunner {
   
   

    private static final String ID = "MANUAL";

    @Autowired
    private Scheduler scheduler;

    @Override
    public void run(ApplicationArguments args) throws