【Java】【SpringBoot】【Quartz】——3.quartz入门 (spring-boot-starter-quartz)

前面学习了quartz的基础使用：https://www.cnblogs.com/luyj00436/p/18781141

前面引用的依赖为：

<dependency>
    <groupId>org.quartz-scheduler</groupId>
    <artifactId>quartz</artifactId>
    <version>2.3.2</version>
</dependency>

后续再搜索中，发现对quartz的引用还有。

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

在SpringBoot中，可以引用它作为定时器。

使用 org.springframework.boot:spring-boot-starter-quartz 的优势包括：

• 简化配置‌。spring-boot-starter-quartz是Spring Boot官方提供的Starter，自动集成了Quartz核心库（如quartz和quartz-jobs），并默认配置了与Spring容器的整合，避免了手动管理依赖版本和复杂配置的问题‌。
• ‌自动装配支持‌。该Starter通过SchedulerFactoryBean自动创建Scheduler实例，并支持通过application.properties或application.yml文件配置Quartz属性（如线程池、数据源等），提升开发效率‌。
• ‌与Spring生态兼容性‌。Starter内置了对Spring事务管理的支持，且能直接将Spring容器中的Bean注入到Quartz任务中（通过AdaptableJobFactory），确保任务逻辑与Spring Bean的无缝协作‌。
• ‌版本一致性‌。Spring Boot Starter会管理Quartz的版本，避免因版本冲突导致的问题。例如，Spring Boot 3.x默认集成Quartz 2.x，而直接引入原生依赖可能需手动处理版本适配‌。

　接下来，重新学习quartz的引用。

 入门使用

新建SpringBoot项目，添加必要的依赖。引入依赖值。这里version与引用的SpringBoot版本一致。

引入依赖

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

添加Job任务。

定义一个需要定时调度的任务

@PersistJobDataAfterExecution   // 支持持久化
@DisallowConcurrentExecution    // 禁止并发执行同一任务
public class HelloQuartz implements Job {
    /**
     * 测试任务
     * @param jobExecutionContext
     * @throws JobExecutionException
     */
    @Override
    public void execute(JobExecutionContext jobExecutionContext) throws JobExecutionException {
        // 获取JobDetail
        JobDetail   jobDetail = jobExecutionContext.getJobDetail();
        JobDataMap jobDataMap = jobDetail.getJobDataMap();
        Integer count = jobDataMap.getInt("count");
        // 输出结果
        System.out.println("[" + jobDetail.getKey().getGroup()  +"][" + jobDetail.getKey().getName() +"][" +count + "]：" +  LocalDateTime.now() );
        // 增加次数
        jobDataMap.put("count",count + 1);     // 增加次数
    }
}

配置任务和定时器

@Configuration
public class QuartzConfig {
    /**
     * 设置一个任务1
     * @return
     * @throws SchedulerException
     */
    @Bean
    public JobDetail jobDetail() throws SchedulerException {
        JobDetail jobDetail = JobBuilder.newJob(HelloQuartz.class)
                .withIdentity("MyJob","group1")
                .usingJobData("count",1)        // 共享初始化数据
                .storeDurably()     // 设置当前任务支持持久化
                .build();
        return jobDetail;
    }

    /**
     * 定义触发器1Q
     * @return
     * @throws SchedulerException
     */
    @Bean
    public Trigger trigger() throws SchedulerException {
        Trigger trigger = TriggerBuilder.newTrigger()
                .forJob(jobDetail())        // 关联任务1（JobDetail）
                .withIdentity("MyTrigger","group1")
                .startNow()     // 触发器开始时间
                .withSchedule(CronScheduleBuilder.cronSchedule("0/5 * * * * ?"))    // Corn表达式，每5秒执行一次
                .build();
        return trigger;
    }
}

配置文件

spring:
  quartz:
    job-store-type: memory  # 使用内存存储（默认）
    properties:
      org.quartz.threadPool.threadCount: 5  # 线程池大小

然后启动任务，任务可以自动调用。