Quartz SimpleTrigger 用法

SimpleTrigger 是 Quartz Scheduler 中的一种触发器，它用于定义一个简单的定时任务。与 CronTrigger 不同，SimpleTrigger 更适合用于那些基于固定间隔的任务调度。下面是一些关于 SimpleTrigger 的基本用法说明。

1. 创建 SimpleTrigger

SimpleTrigger 主要用于基于时间间隔的重复任务调度。你可以使用 SimpleScheduleBuilder 来配置触发器的执行频率和重复方式。下面是创建一个 SimpleTrigger 的基本步骤：

import org.quartz.Trigger;
import org.quartz.TriggerBuilder;
import org.quartz.SimpleScheduleBuilder;

Trigger trigger = TriggerBuilder.newTrigger()
    .withIdentity("triggerName", "triggerGroup")
    .withSchedule(SimpleScheduleBuilder.simpleSchedule()
        .withIntervalInHours(1) // 每隔一小时执行一次
        .repeatForever()) // 无限重复
    .build();

2. 设置触发器的开始时间和结束时间

你可以使用 TriggerBuilder 的 startAt 和 endAt 方法来设置触发器的开始和结束时间：

import org.quartz.DateBuilder;
import java.util.Date;

Trigger trigger = TriggerBuilder.newTrigger()
    .withIdentity("triggerName", "triggerGroup")
    .startAt(DateBuilder.dateOf(12, 0, 0)) // 设置开始时间
    .endAt(DateBuilder.dateOf(18, 0, 0)) // 设置结束时间
    .withSchedule(SimpleScheduleBuilder.simpleSchedule()
        .withIntervalInHours(1) 
        .repeatForever())
    .build();

3. 配置触发器的执行次数

你可以设置触发器的总执行次数（即触发器执行的次数，而不是间隔时间），使用 withRepeatCount 方法：

Trigger trigger = TriggerBuilder.newTrigger()
    .withIdentity("triggerName", "triggerGroup")
    .withSchedule(SimpleScheduleBuilder.simpleSchedule()
        .withIntervalInMinutes(5) // 每5分钟执行一次
        .withRepeatCount(10)) // 执行10次
    .build();

4. 示例：创建和注册 Job 和 Trigger

下面是一个完整的示例，演示如何创建和注册一个 SimpleTrigger，以及关联一个 Job：

import org.quartz.JobBuilder;
import org.quartz.JobDetail;
import org.quartz.Trigger;
import org.quartz.TriggerBuilder;
import org.quartz.SimpleScheduleBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class QuartzConfig {

    @Bean
    public JobDetail jobDetail() {
        return JobBuilder.newJob(MyJob.class)
                .withIdentity("myJob")
                .storeDurably() // 持久化
                .build();
    }

    @Bean
    public Trigger trigger(JobDetail jobDetail) {
        return TriggerBuilder.newTrigger()
                .forJob(jobDetail)
                .withIdentity("myTrigger")
                .withSchedule(SimpleScheduleBuilder.simpleSchedule()
                        .withIntervalInHours(1) // 每隔一小时
                        .repeatForever()) // 无限重复
                .build();
    }
}

5. 触发器的持久化

如果你希望触发器的信息持久化，可以在配置文件中设置 job-store 类型为 jdbc。具体的配置可以参考 Quartz 官方文档 或使用 Spring Boot 提供的自动配置。

6. 注意事项

• SimpleTrigger 不支持复杂的时间表达式和计划，只适用于简单的时间间隔任务。
• 如果需要更复杂的调度策略（如特定时间点的任务），应考虑使用 CronTrigger。

希望这些说明能帮助你更好地理解和使用 SimpleTrigger！如果有更多问题或需要进一步的帮助，请告诉我。