任务调度 Quartz_quartz scheduler状态和单个任务的关系-CSDN博客

本文链接：https://blog.csdn.net/csyuyaoxiadn/article/details/52583489

一、 Quartz 的原理：

Quartz 设计的核心类包括Scheduler（调度器）, Job （任务）以及 Trigger（触发器）。其中，Job 负责定义需要执行的任务，Trigger 负责设置调度策略，Scheduler 将二者组装在一起，并触发任务开始执行。

二、 Quartz 的优点：

1、job 与 Trigger 的松耦合：同一个 Job 可以绑定多个不同的 Trigger，同一个Trigger不可以绑定多个job；可以修改或者替换Trigger，而不用重新定义与之关联的Job，灵活性很强。

2、提供了 listener 的功能：主要包含三种 listener：JobListener，TriggerListener 以及 SchedulerListener。当系统发生故障，相关人员需要被通知时，Listener 便能发挥它的作用。最常见的情况是，当任务被执行时，系统发生故障，Listener 监听到错误，立即发送邮件给管理员

3、持久化：即将任务调度的相关数据保存下来。默认情况下，Quartz 采用的是 org.quartz.simpl.RAMJobStore，在这种情况下，数据仅能保存在内存中，系统重启后会全部丢失。若想持久化数据，需要采用 org.quartz.simpl.JDBCJobStoreTX。

三、 Quartz 下载、安装、配置：

1、下载quartz 2.2.3.tar.gz：http://d2zwv9pap9ylyd.cloudfront.net/quartz-2.2.3-distribution.tar.gz

2、jar包引入

a、maven项目引：

<!-- quartz 任务调度 -->
<dependency>
	<groupId>org.quartz-scheduler</groupId>
	<artifactId>quartz</artifactId>
	<version>2.2.3</version>
</dependency>
<dependency>
	<groupId>org.quartz-scheduler</groupId>
	<artifactId>quartz-jobs</artifactId>
	<version>2.2.3</version>
</dependency>

b、普通项目: 如果你希望在很多应用中使用quartz，将quartz的jar包放在应用服务器的classpath下即可。如果你只是希望在独立的应用中使用quartz，将quartz的jar包和你的应用依赖的其它jar包放在一起即可。
四、 Quartz 相关类介绍：

1、Job：是一个接口，只有一个方法void execute(JobExecutionContext context)，开发者实现该接口定义运行任务，JobExecutionContext类提供了调度上下文的各种信息。Job运行时的信息保存在JobDataMap实例中；
2、Trigger：是一个类，描述触发Job执行的时间触发规则。主要有SimpleTrigger和CronTrigger这两个子类。SimpleTrigger：当仅需触发一次或者以固定时间间隔周期执行；CronTrigger：可以通过Cron表达式定义出各种复杂时间规则的调度方案：如每早晨9:00执行，周一、周三、周五下午5:00执行等；

3、Scheduler：代表一个Quartz的独立运行容器，Trigger和JobDetail可以注册到Scheduler中，两者在Scheduler中拥有各自的组及名称，组及名称是Scheduler查找定位容器中某一对象的依据，Trigger的组及名称必须唯一，JobDetail的组和名称也必须唯一（但可以和Trigger的组和名称相同，因为它们是不同类型的）。Scheduler可以将Trigger绑定到某一JobDetail中，这样当Trigger触发时，对应的Job就被执行。

4、JobDetail：Quartz在每次执行Job时，都重新创建一个Job实例，所以它不直接接受一个Job的实例，相反它接收一个Job实现类，以便运行时通过newInstance()的反射机制实例化Job。因此需要通过一个类来描述Job的实现类及其它相关的静态信息，如Job名字、描述、关联监听器等信息，JobDetail承担了这一角色。

5、Calendar：org.quartz.Calendar和java.util.Calendar不同，它是一些日历特定时间点的集合（可以简单地将org.quartz.Calendar看作java.util.Calendar的集合——java.util.Calendar代表一个日历时间点，无特殊说明后面的Calendar即指org.quartz.Calendar）。一个Trigger可以和多个Calendar关联，以便排除或包含某些时间点。

6、ThreadPool：Scheduler使用一个线程池作为任务运行的基础设施，任务通过共享线程池中的线程提高运行效率。

五、 Quartz 的使用：

import static org.quartz.DateBuilder.futureDate;
import static org.quartz.JobBuilder.newJob;
import static org.quartz.JobKey.jobKey;
import static org.quartz.SimpleScheduleBuilder.simpleSchedule;
import static org.quartz.TriggerBuilder.newTrigger;
import java.util.Date;
import org.quartz.DateBuilder.IntervalUnit;
import org.quartz.Job;
import org.quartz.JobDetail;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;
import org.quartz.Scheduler;
import org.quartz.SchedulerException;
import org.quartz.SchedulerMetaData;
import org.quartz.SimpleTrigger;
import org.quartz.impl.StdSchedulerFactory;

public class QuartzController implements Job {

    @Override
    public void execute(JobExecutionContext arg0) throws JobExecutionException {
        System.out.println("yyx's jobTest:Description=" + arg0.getJobDetail().getKey() + ",type=" + arg0.getJobDetail().getJobDataMap().get("type"));
        System.out.println(new Date());
    }

    public static void main(String[] args) {
        try {
            // 创建调度器
            Scheduler scheduler = StdSchedulerFactory.getDefaultScheduler();
            scheduler.start();//调度开启
            // 创建该Job负责定义需要执行任务
            JobDetail job1 = newJob(QuartzController.class).withIdentity("job1", "group1").usingJobData("type", "yyx1").build();
            // 创建触发器立即执行 默认执行一次
            SimpleTrigger trigger1 = (SimpleTrigger) newTrigger().withIdentity("myTrigger1", "group1").startNow().build();
            Date df = scheduler.scheduleJob(job1, trigger1);// 执行一次

            // 立即执行 5s一次执行5次
            JobDetail job2 = newJob(QuartzController.class).withIdentity("job2", "group1").usingJobData("type", "yyx2").build();
            SimpleTrigger trigger2 = newTrigger().withIdentity("myTrigger2", "group2").startNow().withSchedule(simpleSchedule().withIntervalInSeconds(5).withRepeatCount(5)).build();
            df = scheduler.scheduleJob(job2, trigger2);

            // 给触发器绑定任务forJob(job3)
            JobDetail job3 = newJob(QuartzController.class).withIdentity("job3", "group1").usingJobData("type", "yyx3").build();
            SimpleTrigger trigger3 = newTrigger().withIdentity("myTrigger3", "group3").startNow().withSchedule(simpleSchedule().withIntervalInSeconds(5).withRepeatCount(5)).forJob(job3).build();
            df = scheduler.scheduleJob(job3, trigger3);

            // 设定5分钟后运行futureDate(5, IntervalUnit.MINUTE)
            JobDetail job4 = newJob(QuartzController.class).withIdentity("job4", "group1").usingJobData("type", "yyx4").build();
            SimpleTrigger trigger4 = (SimpleTrigger) newTrigger().withIdentity("trigger4", "group4").startAt(futureDate(5, IntervalUnit.MINUTE)).build();
            df = scheduler.scheduleJob(job4, trigger4);

            // 一直执行repeatForever()
            JobDetail job5 = newJob(QuartzController.class).withIdentity("job5", "group1").usingJobData("type", "yyx5").build();
            SimpleTrigger trigger5 = newTrigger().withIdentity("myTrigger5", "group5").startNow().withSchedule(simpleSchedule().withIntervalInSeconds(5).repeatForever()).build();
            df = scheduler.scheduleJob(job5, trigger5);

            // 手动触发 storeDurably:是否有触发器
            JobDetail job6 = newJob(QuartzController.class).withIdentity("job6", "group1").storeDurably().build();
            scheduler.addJob(job6, true);
            scheduler.triggerJob(jobKey("job6", "group1"));

            try {
                Thread.sleep(5 * 60 * 1000);// 等待5分钟
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
            scheduler.shutdown();// 关闭调度
            SchedulerMetaData meta = scheduler.getMetaData();
            System.out.println("已经执行的job个数：" + meta.getNumberOfJobsExecuted());
        } catch (SchedulerException e) {
            e.printStackTrace();
        }    
    }
}

注意：同一个Trigger不可以绑定多个job，如下代码运行时会报下面的错误。

try {
                scheduler.scheduleJob(job1, trigger1);
                Thread.sleep(2 * 1000);
                scheduler.scheduleJob(job2, trigger1);
                Thread.sleep(2 * 1000);
                scheduler.scheduleJob(job3, trigger1);
            } catch (InterruptedException e) {
                e.printStackTrace();
            }