定时任务-Quartz-Trigger

实现

  1. SimpleTrigger:简单触发器,支持定义任务执行的间隔时间,执行次数的规则有两种,一是定义重复次数,二是定义开始时间和结束时间。如果同时设置了结束时间与重复次数,先结束的会覆盖后结束的,以先结束的为准。
  2. CronTrigger:基于Cron表达式的触发器。
  3. CalendarIntervalTrigger:基于日历的触发器,比简单触发器更多时间单位,且能智能区分大小月和平闰年。
  4. DailyTimeIntervalTrigger:基于日期的触发器,如每天的某个时间段。

状态

Quartz自带的表里面

  1. triggers表。triggers表里记录了,某个trigger的PREV_FIRE_TIME(上次触发时间),NEXT_FIRE_TIME(下一次触发时间),TRIGGER_STATE(当前状态)。虽未尽述,但是本文用到的只有这些。
  2. locks表。Quartz支持分布式,也就是会存在多个线程同时抢占相同资源的情况,而Quartz正是依赖这张表,处理这种状况
  3. fired_triggers表,记录正在触发的triggers信息。

属性

  1. jobKey属性∶当trigger触发时被执行的job的身份,可停止某个key的定时任务
  2. startTime属性∶设置trigger第一次触发的时间; startNow() 立即执行
  3. endTime属性∶表示trigger失效的时间点
  4. 优先级(priority) 同时执行,并且工作线程数少于trriger数
  5. 错过触发(misfire Instructions)
  6. 日历示例(calendar)

优先级

@PersistJobDataAfterExecution
public class Myjob implements Job {

    @Setter@Getter
    private  int count;
    @SneakyThrows
    @Override
    public void execute(JobExecutionContext context) throws JobExecutionException {
        DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
        LocalDateTime now = LocalDateTime.now();
        count++;
        context.getJobDetail().getJobDataMap().put("count",count);
        System.out.println(count);
        Thread.sleep(1000);
    }
}
public class TrigerPriorityTest {
    public static void main(String[] args) {
        String ss="0/2 * * * * ? *";
        try {
            Scheduler scheduler = StdSchedulerFactory.getDefaultScheduler();

            JobDetail jobDetail1 = JobBuilder.newJob(MyJobDemo.class).withIdentity("test1", "Tests")
            .withDescription("初次测试")
            .usingJobData("count",1)
            .build();

            JobDetail jobDetail2 = JobBuilder.newJob(MyJobDemo.class).withIdentity("test", "Tests")
            .withDescription("初次测试")
            .usingJobData("count",2)
            .build();

            Date date = DateBuilder.futureDate(15, DateBuilder.IntervalUnit.SECOND);

            Trigger simpleTrigger1 = TriggerBuilder.newTrigger()
            .withDescription("测试触发器")
            .withPriority(4)
            .startAt(date)
            .withSchedule(CronScheduleBuilder.cronSchedule(ss))
            .build();

            Trigger simpleTrigger2 = TriggerBuilder.newTrigger()
            .withDescription("测试触发器")
            .withPriority(9)
            .startAt(date)
            .withSchedule(CronScheduleBuilder.cronSchedule(ss))
            .build();

            scheduler.scheduleJob(jobDetail1,simpleTrigger1);
            scheduler.scheduleJob(jobDetail2,simpleTrigger2);
            scheduler.start();

            TimeUnit.SECONDS.sleep(50);

        } catch (SchedulerException | InterruptedException e) {
            e.printStackTrace();
        }
    }
}

SimpleTrigger

  1. 可以具体时间点执行一次
  2. 可以按照指定间隔时间重复若干次
  3. 重要属性:开始时间、结束时间、重复次数、重复间隔
  4. 重复次数:0、正整数、无限次执行
  5. 重复间隔:0(并发执行)、long型(毫秒级)
@Getter
@Slf4j
public class MyJobDemo implements Job {

    @Setter
    private  int count;
    @SneakyThrows
    @Override
    public void execute(JobExecutionContext context) throws JobExecutionException {
        DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
        LocalDateTime now = LocalDateTime.now();

        //获取参数
        JobDataMap jobDataMap = context.getJobDetail().getJobDataMap();
        Date nextFireTime = context.getNextFireTime();
        jobDataMap.forEach((k,v)->{
            log.info("k{},v{}",k,v);
        });

        //更新参数
        count++;
        context.getJobDetail().getJobDataMap().put("count",count);
        log.info(String.valueOf(count));
    }
}

withIntervalInSeconds,有许多的时间单位

@Configuration
public class QuartzConfig {

    @Bean
    public JobDetail myJobDetail() {
        return JobBuilder.newJob(MyJobDemo.class)
                .withIdentity("SpringBoot2", "SpringBoot")
                .usingJobData("du", "ruilong")
                .storeDurably()
                .build();
    }

    @Bean
    public Trigger myTriger() {
        return TriggerBuilder.newTrigger()
                .withIdentity("sp2", "sp2")
                .withPriority(10)
                .startNow()
                .forJob(myJobDetail())
                .withSchedule(SimpleScheduleBuilder
                        .simpleSchedule()
                        .repeatForever()
                        .withIntervalInSeconds(3)
                ).build();
    }
}

CronTrigger

.withSchedule(CronScheduleBuilder.cronSchedule(ss))

MisFire

public class MisFireTest {
    public static void main(String[] args) {
        try {
            /**
             * 读取配置文件
             */
            Scheduler sc = StdSchedulerFactory.getDefaultScheduler();
            JobDetail build = JobBuilder.newJob(MyjobMisfire.class).storeDurably()
            .withIdentity("测试错误补偿", "补偿组")
            .usingJobData("bu", "chang")
            .withDescription("测试补偿的组")
            .build();
            CronTrigger cronTrigger = TriggerBuilder.newTrigger()
            .withIdentity("测试错误补偿", "补偿组")
            .withSchedule(
                CronScheduleBuilder.cronSchedule("0/5 * * * * ? *")
                .withMisfireHandlingInstructionIgnoreMisfires()
                .withMisfireHandlingInstructionFireAndProceed()
                //.withMisfireHandlingInstructionDoNothing()
            )
            .startNow()
            .build();
            sc.scheduleJob(build,cronTrigger);
            sc.start();

        } catch (SchedulerException e) {
            e.printStackTrace();
        }
    }
}
public class TriggrtListerTest {
    public static void main(String[] args) {
        try {

            Scheduler sc = StdSchedulerFactory.getDefaultScheduler();
            JobDetail build = JobBuilder.newJob(MyjobMisfire.class).storeDurably()
                    .withIdentity("触发器", "触发器组")
                    .usingJobData("bu", "chang")
                    .withDescription("测试触发器的组")
                    .build();
            CronTrigger cronTrigger = TriggerBuilder.newTrigger()
                    .withIdentity("触发器监听器", "触发器组")
                    .withSchedule(
                            CronScheduleBuilder.cronSchedule("0/5 * * * * ? *")
                    )
                    .startNow()
                    .build();
            sc.getListenerManager().addTriggerListener(new MyTriggerListener());
            sc.scheduleJob(build,cronTrigger);
            sc.start();

        } catch (SchedulerException e) {
            e.printStackTrace();
        }
    }
}

 全局策略

MISFIRE_INSTRUCTION_SMART_POLICY

所有的Trigger的MisFire默认值都是这个,大致意思是“把处理逻辑交给聪明的Quartz去决定”。

基本策略是,

如果是只执行一次的调度,使用MISFIRE_INSTRUCTION_FIRE_NOW

如果是无限次的调度(repeatCount是无限的),使用

MISFIRE_INSTRUCTION_RESCHEDULE_NEXT_WITH_REMAINING_COUNT

否则,使用

MISFIRE_INSTRUCTION_RESCHEDULE_NOW_WITH_EXISTING_REPEAT_COUNT

MISFIRE_INSTRUCTION_FIRE_NOW

忽略已经MisFire的任务,并且立即执行调度。这通常只适用于只执行一次的任务。

MISFIRE_INSTRUCTION_RESCHEDULE_NOW_WITH_EXISTING_REPEAT_COUNT

将startTime设置当前时间,立即重新调度任务,包括的MisFire的

MISFIRE_INSTRUCTION_RESCHEDULE_NOW_WITH_REMAINING_REPEAT_COUNT

类似MISFIRE_INSTRUCTION_RESCHEDULE_NOW_WITH_EXISTING_REPEAT_COUNT,区别在于会忽略已经MisFire的任务

 MISFIRE_INSTRUCTION_RESCHEDULE_NEXT_WITH_EXISTING_COUNT

在下一次调度时间点,重新开始调度任务,包括的MisFire的

 MISFIRE_INSTRUCTION_RESCHEDULE_NEXT_WITH_REMAINING_COUNT

类似于MISFIRE_INSTRUCTION_RESCHEDULE_NEXT_WITH_EXISTING_COUNT,区别在于会忽略已经MisFire的任务。

MISFIRE_INSTRUCTION_SMART_POLICY

所有的Trigger的MisFire默认值都是这个,大致意思是“把处理逻辑交给聪明的Quartz去决定”。

基本策略是,

如果是只执行一次的调度,使用MISFIRE_INSTRUCTION_FIRE_NOW

如果是无限次的调度(repeatCount是无限的),使用

MISFIRE_INSTRUCTION_RESCHEDULE_NEXT_WITH_REMAINING_COUNT

否则,使用

MISFIRE_INSTRUCTION_RESCHEDULE_NOW_WITH_EXISTING_REPEAT_COUNT

withMisfireHandlingInstructionFireAndProceed

错过立即执行

CronTrigger

withMisfireHandlingInstructionDoNothing

不触发立即执行

等待下次Cron触发频率到达时刻开始按照Cron频率依次执行

错过的时间小于设置的时间5秒, 还是会补偿执行

org.quartz.jobStore.misfireThreshold=1000 错过则不执行

CronTrigger cronTrigger = TriggerBuilder.newTrigger()
        .withIdentity("测试错误补偿", "补偿组")
        .withSchedule(
                CronScheduleBuilder.cronSchedule("0/5 * * * * ? *")
                        .withMisfireHandlingInstructionDoNothing()
        )
        .startNow()
        .build();

withMisfireHandlingInstructionIgnoreMisfires

以错过的第一个频率时间立刻开始执行

重做错过的所有频率周期后

当下一次触发频率发生时间大于当前时间后,再按照正常的Cron频率依次执行

withMisfireHandlingInstructionFireAndProceed

以当前时间为触发频率立刻触发一次执行

然后按照Cron频率依次执行

SimpleTrigger

withMisfireHandlingInstructionFireNow

以当前时间为触发频率立即触发执行

执行至FinalTIme的剩余周期次数

以调度或恢复调度的时刻为基准的周期频率,FinalTime根据剩余次数和当前时间计算得到

调整后的FinalTime会略大于根据starttime计算的到的FinalTime值

withMisfireHandlingInstructionIgnoreMisfires

以错过的第一个频率时间立刻开始执行

重做错过的所有频率周期

当下一次触发频率发生时间大于当前时间以后,按照Interval的依次执行剩下的频率

共执行RepeatCount+1次

withMisfireHandlingInstructionNextWithExistingCount

不触发立即执行

等待下次触发频率周期时刻,执行至FinalTime的剩余周期次数

以startTime为基准计算周期频率,并得到FinalTime

即使中间出现pause,resume以后保持FinalTime时间不变

withMisfireHandlingInstructionNowWithExistingCount

以当前时间为触发频率立即触发执行

执行至FinalTIme的剩余周期次数

以调度或恢复调度的时刻为基准的周期频率,FinalTime根据剩余次数和当前时间计算得到

调整后的FinalTime会略大于根据starttime计算的到的FinalTime值

withMisfireHandlingInstructionNextWithRemainingCount

不触发立即执行

等待下次触发频率周期时刻,执行至FinalTime的剩余周期次数

以startTime为基准计算周期频率,并得到FinalTime

即使中间出现pause,resume以后保持FinalTime时间不变

withMisfireHandlingInstructionNowWithRemainingCount

以当前时间为触发频率立即触发执行

执行至FinalTIme的剩余周期次数

以调度或恢复调度的时刻为基准的周期频率,FinalTime根据剩余次数和当前时间计算得到

调整后的FinalTime会略大于根据starttime计算的到的FinalTime值

MISFIRE_INSTRUCTION_IGNORE_MISFIRE_POLICY

这个不是忽略已经错失的触发的意思,而是说忽略MisFire策略。它会在资源合适的时候,重新触发所有的MisFire任务,并且不会影响现有的调度时间。

比如,SimpleTrigger每15秒执行一次,而中间有5分钟时间它都MisFire了,一共错失了20个,5分钟后,假设资源充足了,并且任务允许并发,它会被一次性触发。

这个属性是所有Trigger都适用。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值