1 SchedulerFactory

1.1 概述

Quartz是以模块的方式构建的，因为，要使它运行，几个组件必须很好的组合在一起。非常幸运的是，已经有了一些现存的助手可以完成这些工作。
所有Scheduler实例都是由SchedulerFactory创建的。
Quartz的三个核心概念：调度器（Scheduler）、任务（Job）和触发器（Trigger），三者之间的关系是：

一个作业，比较重要的的三个要素就是Scheduler、JobDetail和Trigger。而Trigger对于Job而言就好比是一个驱动器；没有触发器来定时驱动作业，作业就无法运行；对于Job而言，一个Job可以对应多个Trigger，但是对于Trigger而言，一个Trigger只能对应一个Job；所以一个Trigger只能被指派给一个Job；如果你需要更复杂的触发计划，你可以创建多个Trigger并指派它们给同一个Job。

1.2 Scheduler的创建方式

1.2.1 StdSchedulerFactory

Quartz默认使用的是StdSchedulerFactory。

使用一组参数（java.util.Properties）来创建和初始化Quartz调度器。
配置参数一般存储在quartz.properties文件中。
调用getScheduler方法就可以创建和初始化调度器对象。

StdSchedulerFactory fact = new StdSchedulerFactory();
Scheduler scheduler = fact.getScheduler();

1.2.1.1 输出调度器开始的时间：

    Date scheduleJob(JobDetail jobDetail, Trigger trigger)
        throws SchedulerException;

示例：
MailJob.java

package com.sunxiaping;


import org.quartz.Job;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;

import java.util.Date;


public class MailJob implements Job {

    public void execute(JobExecutionContext context) throws JobExecutionException {
        System.out.println("当前时间是："+new Date());

    }
}

View Code

QuartzTest.java

package com.sunxiaping;

import org.quartz.*;
import org.quartz.impl.StdSchedulerFactory;

import java.util.Date;

/**
 * Quartz测试
 */
public class QuartzTest {

    public static void main(String[] args) throws SchedulerException {
        Date startDate = new Date();
        startDate.setTime(startDate.getTime() + 3000);

        Date endDate = new Date();
        endDate.setTime(endDate.getTime() + 10000);

        JobDetail jobDetail = JobBuilder.newJob(MailJob.class)
                .withIdentity("job1", "group1")
                .build();

        Trigger trigger = TriggerBuilder.newTrigger()
                .withIdentity("trigger1", "group1")
                .startNow() //立即开始，在Scheduler调度器开启之后
                .withSchedule(CronScheduleBuilder.cronSchedule("* * * * * ?"))
                .build();

        Scheduler scheduler = StdSchedulerFactory.getDefaultScheduler();

        Date date = scheduler.scheduleJob(jobDetail, trigger);
        System.out.println("调度器开始时间：" + date);

        scheduler.start();


    }

}

1.2.1.2 启动任务调度

void start() throws SchedulerException;

1.2.1.3 任务调度挂起，即暂停

void standby() throws SchedulerException;

示例：
MailJob.java

package com.sunxiaping;


import org.quartz.Job;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;

import java.util.Date;


public class MailJob implements Job {

    public void execute(JobExecutionContext context) throws JobExecutionException {
        System.out.println("当前时间是："+new Date());

    }
}

View Code

QuartzTest.java

package com.sunxiaping;

import org.quartz.*;
import org.quartz.impl.StdSchedulerFactory;

import java.util.Date;

/**
 * Quartz测试
 */
public class QuartzTest {

    public static void main(String[] args) throws SchedulerException, InterruptedException {
        Date startDate = new Date();
        startDate.setTime(startDate.getTime() + 3000);

        Date endDate = new Date();
        endDate.setTime(endDate.getTime() + 10000);

        JobDetail jobDetail = JobBuilder.newJob(MailJob.class)
                .withIdentity("job1", "group1")
                .build();

        Trigger trigger = TriggerBuilder.newTrigger()
                .withIdentity("trigger1", "group1")
                .startNow() //立即开始，在Scheduler调度器开启之后
                .withSchedule(CronScheduleBuilder.cronSchedule("* * * * * ?"))
                .build();

        Scheduler scheduler = StdSchedulerFactory.getDefaultScheduler();

        scheduler.scheduleJob(jobDetail, trigger);


        scheduler.start();

        //Scheduler执行2秒后自动挂起
        Thread.sleep(2000L);
        scheduler.standby();

        //Scheduler执行5秒后自动开启
        Thread.sleep(5000L);
        scheduler.start();

    }

}

1.2.1.4 关闭任务调度

void shutdown() throws SchedulerException;

void shutdown(boolean waitForJobsToComplete)
        throws SchedulerException;

如果shutdown中的参数是true：表示等待所有正在执行的Job执行完毕之后，再关闭Scheduler。
如果shutdown中的参数是false：表示直接关闭Scheduler。

示例：
MailJob.java

package com.sunxiaping;


import org.quartz.Job;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;

import java.util.Date;


public class MailJob implements Job {

    public void execute(JobExecutionContext context) throws JobExecutionException {
        System.out.println("当前时间是："+new Date());

    }
}

View Code

QuartzTest.java

package com.sunxiaping;

import org.quartz.*;
import org.quartz.impl.StdSchedulerFactory;

import java.util.Date;

/**
 * Quartz测试
 */
public class QuartzTest {

    public static void main(String[] args) throws SchedulerException, InterruptedException {
        Date startDate = new Date();
        startDate.setTime(startDate.getTime() + 3000);

        Date endDate = new Date();
        endDate.setTime(endDate.getTime() + 10000);

        JobDetail jobDetail = JobBuilder.newJob(MailJob.class)
                .withIdentity("job1", "group1")
                .build();

        Trigger trigger = TriggerBuilder.newTrigger()
                .withIdentity("trigger1", "group1")
                .startNow() //立即开始，在Scheduler调度器开启之后
                .withSchedule(CronScheduleBuilder.cronSchedule("* * * * * ?"))
                .build();

        Scheduler scheduler = StdSchedulerFactory.getDefaultScheduler();

        scheduler.scheduleJob(jobDetail, trigger);


        scheduler.start();

        Thread.sleep(2000L);
        scheduler.shutdown(true);

    }

}

1.2.2 DirectSchedulerFactory（了解）

DirectSchedulerFactory是对SchedulerFactory的直接实现，通过它可以直接构建Scheduler、ThreadPool等。

DirectSchedulerFactory directSchedulerFactory = DirectSchedulerFactory.getInstance();
Scheduler scheduler = directSchedulerFactory.getScheduler();

2 Quartz.properties

默认路径是:quartzjar包中org.quartz中的quartz.properties。

# Default Properties file for use by StdSchedulerFactory
# to create a Quartz Scheduler Instance, if a different
# properties file is not explicitly specified.
#

org.quartz.scheduler.instanceName: DefaultQuartzScheduler
org.quartz.scheduler.rmi.export: false
org.quartz.scheduler.rmi.proxy: false
org.quartz.scheduler.wrapJobExecutionInUserTransaction: false

org.quartz.threadPool.class: org.quartz.simpl.SimpleThreadPool
org.quartz.threadPool.threadCount: 10
org.quartz.threadPool.threadPriority: 5
org.quartz.threadPool.threadsInheritContextClassLoaderOfInitializingThread: true

org.quartz.jobStore.misfireThreshold: 60000

org.quartz.jobStore.class: org.quartz.simpl.RAMJobStore

View Code

我们也可以自己新建一个quartz.properties文件覆盖掉原来的quartz.properties文件。

调度器属性：
org.quartz.scheduler.instanceName属性用来区分特定的调度器实例，可以按照功能用途来给调度器命名。
org.quartz.scheduler.instanceId属性和前者一样，也允许任何字符串，但是这个值必须在所有调度器实例中是唯一的，尤其是一个集群环境中，作为集群中的唯一key。如果你想Quartz帮你生成这个值的话，可以设置为AUTO。

线程池属性：
org.quartz.threadPool.threadCount：处理Job的线程个数，至少为1，但是最多的话不要超过100，在多数机器上设置该值超过100的话就会显得相当不实用了，特别是在你的Job执行时间较长的情况下。
org.quartz.threadPool.threadPriority：线程的优先级，优先级级别高的线程比优先级级别低的线程优先得到执行。最小为1，最大为10，默认为5。
org.quartz.threadPool.class：一个实现了org.quartz.spi.ThreadPool接口的类，Quartz自带的线程池的实现类是org.quartz.simpl.SimpleThreadPool。

作业存储设置：
描述了调度器实例的生命周期中，Job和Trigger信息是如何存储的。

插件配置：
满足特定需求用到的Quartz插件的配置。

3 Quartz监听器

3.1 概述

Quartz的监听器用于当任务调度中你所关注的事件发生的时候，能够及时获取这一事件的通知。
类似于任务执行过程中的邮件、短信类的提醒。
Quartz的监听器主要有TriggerListener、JobListener、SchedulerListener三种，顾名思义，分别表示任务、触发器、调度器对应的监听器。
三者的使用方法类似，在开始介绍三种监听器之前，需要明确两个概念：全局监听器和非全局监听器，二者的区别在于：全局监听器能够接收到所有的Job/Trigger的事件通知，而非全局监听器只能接收到在其上注册的Job或Trigger的事件。

3.2 JobListener

任务调度的过程中，和任务Job相关的事件包括：Job开始要执行的提示。Job执行完成的提示。

package org.quartz;


public interface JobListener {
    
    
    String getName();

   
    void jobToBeExecuted(JobExecutionContext context);

   
    void jobExecutionVetoed(JobExecutionContext context);


    void jobWasExecuted(JobExecutionContext context,
            JobExecutionException jobException);

}

其中：
getName方法：用于获取该JobListener的名称。
jobToBeExecuted方法：Scheduler在JobDetail将要被执行的时候调用这个方法。
jobExecutionVetoed方法：Scheduler在JobDetail即将被执行，但又被TriggerListener否决时会调用该方法。
jobWasExecuted方法：Scheduler在JobDetail被执行之后调用此方法。

示例：
MailJob.java

Quartz（二）

1 SchedulerFactory

1.1 概述

1.2 Scheduler的创建方式

1.2.1 StdSchedulerFactory

1.2.1.1 输出调度器开始的时间：

1.2.1.2 启动任务调度

1.2.1.3 任务调度挂起，即暂停

1.2.1.4 关闭任务调度

1.2.2 DirectSchedulerFactory（了解）

2 Quartz.properties

3 Quartz监听器

3.1 概述

3.2 JobListener

猜你喜欢