Quartz - Scheduled

Quartz中文文档

重要的几个接口

• Scheduler 任务调度相关的API接口
• Job 任务执行的内容，业务逻辑实现。 实例类：JobDetail、JobBuilder
• Trigger：触发器，定义定时任务的触发规则。 实例类：TriggerBuilder

调度器的生命周期

1. 创建 SchedulerFactory，获取 Scheduler 实例。
2. 创建 Job 实例 JobDetail，编写业务需求。
3. 创建 Trigger 实例，根据规则创建。
4. 启动 Scheduler
5. 停止 Scheduler 使用 shutdown()

Job 本质和 Job 的生命周期

1. 创建 JobDetail 时提供了 Job.class 对象，这样 Scheduler(调度器)  会知道执行的 Job 类型
2. 调度器执行时，会先创建一个新的 Job 实例，再调用 excecute() 。
3. 调用 excecute() 完成后，关联的 Job 实例会被释放，被垃圾回收机制回收掉。

注意事项：

 ①  由于调用过程，在使用默认的 JobFactory 实现时，需要 Job 对象必须有一个无参数的构造器。

 ②  Job 类不能定义状态数据字段，因为在任务执行时，这些状态是不会被保存的。

Trigger 触发器的使用

Trigger 通用参数

    ①  jobKey 表示 Job 实例的标识

    ②  startTime 首次触发时间
③  endTime 不再被触发的时间，是指在 startTime - endTime 中以某种规则执行后，到endTime就不再执行。

使用corn 创建 Trigger

trigger = newTrigger()  .withIdentity("trigger3", "group1")  .withSchedule(cronSchedule("0 0/2 8-17 * * ?"))  .forJob("myJob", "group1")  .build();

作业任务监听器

 作用：Job 被执行时的前置通知，后置通知，以及异常通知

import lombok.extern.slf4j.Slf4j;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;
import org.quartz.JobKey;
import org.quartz.JobListener;
import org.springframework.util.ObjectUtils;/*** 自定义 任务监听器*/
@Slf4j
public class MyJobListener implements JobListener {@Overridepublic String getName() {return "任务监听器";}@Overridepublic void jobToBeExecuted(JobExecutionContext context) {// 开始执行JobKey key = context.getJobDetail().getKey();log.info("开始执行 JOB " + key);}@Overridepublic void jobExecutionVetoed(JobExecutionContext context) {// 执行否决了JobKey key = context.getJobDetail().getKey();log.info("执行错误 JOB " + key);}@Overridepublic void jobWasExecuted(JobExecutionContext context, JobExecutionException jobException) {// 执行完成if (!ObjectUtils.isEmpty(jobException)) {log.error("任务执行错误，抛出异常：" + jobException.getMessage());} else {JobKey key = context.getJobDetail().getKey();log.info("执行完成 JOB " + key);}}
}

 如何使用监听器

scheduler.getListenerManager().addJobListener(MyJobListener.class,KeyMatcher.jobKeyEquals(new JobKey("JobName","jobGroup")))

测试项目路径

如有问题，请在下方留下您宝贵的建议！