quartz配置使用及扩展（支持集群）

1        概念

Quartz是一个完全由java编写的开源作业调度框架。开放源码项目,提供丰富的作业调度集，根据实际业务，支持集群配置。

2        组成

主要内容包含四个部分：Scheduler、Trigger、JobDetail、Calendar

    Scheduler

一个计划调度器容器，容器里面可以盛放众多的JobDetail和trigger，当容器启动后，里面的每个JobDetail都会根据trigger按部就班自动去执行

    Trigger

触发器，用于定义任务调度时间规则，代表一个调度参数的配置，什么时候去调

    JobDetail

任务，即被调度的任务，本身可能是有状态的

    Calendar

工作日历，可以控制节假日和一些特殊日期不执行定时任务

 

 

3        内容解析

3.1      Java代码实现

        首先引入quartz的依赖，如我用的是

<dependency>
    <groupId>org.quartz-scheduler</groupId>
    <artifactId>quartz</artifactId>
    <version>2.2.3</version>
</dependency>

接下来我们由下向上说下java代码实现部分

u  Job是一个接口，只有一个方法void execute(JobExecutionContext context)，开发者实现该接口定义运行任务是JobDetail调用的任务，实现类中execute中实现自己的业务逻辑，如

@DisallowConcurrentExecution@PersistJobDataAfterExecution@Slf4jpublic class SimpleJob implements Job {    @Autowired    SimpleService simpleService;    public void execute(JobExecutionContext context)            throws JobExecutionException {        log.info(this.getClass().getName() + " 开始执行了!");        simpleService.simpleMethod();        log.info(this.getClass().getName() + " 执行完了!");    }}

说明：@PersistJobDataAfterExecution@DisallowConcurrentExecution这两个注解在定义job的时候最好添加上，以防定义相同的任务的并发执行

u  JobDetail是一个接口，每次使用的时候需要通过JobBuilder去实例化一个job,并且包含任务的一些详细信息，如Job名字、描述、关联监听器等信息。如

u  Trigger 是一个类，描述触发Job执行的时间触发规则, 主要有SimpleTrigger和CronTrigger这两个子类。当仅需触发一次或者以固定时间间隔周期执行，SimpleTrigger是最适合的选择；而CronTrigger则可以通过Cron表达式定义出各种复杂时间规则的调度方案：如每早晨9:00执行，周一、周三、周五下午5:00执行等；这里我们主要是使用CronTrigger，因为这个更加灵活，接下来上代码

u  Calendar：org.quartz.Calendar和java.util.Calendar不同，它是一些日历特定时间点的集合。一个Trigger可以和多个Calendar关联，以便排除或包含某些时间点。如我们设定法定假日，因为每年的日期都不一样，所以不方便维护到cron的表达式中，这样我们只需要维护一下这个日历数据就可以定点排除这个日期了。定义好日历后将日历加入调度器。

 

u  Scheduler：代表一个Quartz的独立运行容器，Trigger和JobDetail可以注册到Scheduler中，两者在Scheduler中拥有各自的组及名称，组及名称是Scheduler查找定位容器中某一对象的依据。Scheduler定义了多个接口方法，允许外部通过组及名称访问和控制容器中Trigger和JobDetail。Scheduler包含了很多方法，添加、执行一次、恢复全部、删掉任务暂停全部等方法，方便用户灵活使用

 

3.2      数据库表

Quartz在实现上有两种方式，一种将任务调度放到内存中，一种需要做持久化，如果我们做quartz集群配置，那么我们肯定需要持久化，这里我们以持久化为例建立数据库表。

u 表

Ø   QRTZ_CALENDARS 以 Blob 类型存储 Quartz 的 Calendar 信息

Ø   QRTZ_CRON_TRIGGERS 存储 Cron Trigger，包括 Cron表达式和时区信息

Ø   QRTZ_FIRED_TRIGGERS 存储与已触发的 Trigger 相关的状态信息，以及相联 Job的执行信息 QRTZ_PAUSED_TRIGGER_GRPS 存储已暂停的 Trigger 组的信息

Ø   QRTZ_SCHEDULER_STATE 存储少量的有关 Scheduler 的状态信息，和别的 Scheduler实例(假如是用于一个集群中)

Ø   QRTZ_LOCKS 存储程序的悲观锁的信息(假如使用了悲观锁)

Ø   QRTZ_JOB_DETAILS 存储每一个已配置的 Job 的详细信息

Ø   QRTZ_JOB_LISTENERS 存储有关已配置的 JobListener 的信息

Ø   QRTZ_SIMPLE_TRIGGERS 存储简单的Trigger，包括重复次数，间隔，以及已触的次数

Ø   QRTZ_BLOG_TRIGGERS Trigger 作为 Blob 类型存储(用于 Quartz 用户用 JDBC创建他们自己定制的 Trigger 类型，JobStore 并不知道如何存储实例的时候)

Ø   QRTZ_TRIGGER_LISTENERS 存储已配置的 TriggerListener 的信息

Ø   QRTZ_TRIGGERS 存储已配置的 Trigger 的信息

u 主要表字段说明

Ø  表qrtz_job_details: 保存job详细信息,该表需要用户根据实际情况初始化

job_name:集群中job的名字,该名字用户自己可以随意定制,无强行要求

job_group:集群中job的所属组的名字,该名字用户自己随意定制,无强行要求

job_class_name:集群中个note job实现类的完全包名,quartz就是根据这个路径到classpath找到该job类

is_durable:是否持久化,把该属性设置为1，quartz会把job持久化到数据库中

job_data:一个blob字段，存放持久化job对象

 

Ø  表qrtz_triggers: 保存trigger信息

trigger_name:trigger的名字,该名字用户自己可以随意定制,无强行要求

trigger_group:trigger所属组的名字,该名字用户自己随意定制,无强行要求

job_name:qrtz_job_details表job_name的外键

job_group:qrtz_job_details表job_group的外键

trigger_state:当前trigger状态，设置为ACQUIRED,如果设置为WAITING,则job不会触发

trigger_cron:触发器类型,使用cron表达式

 

Ø  表qrtz_cron_triggers:存储cron表达式表

trigger_name:qrtz_triggers表trigger_name的外键

trigger_group:qrtz_triggers表trigger_group的外键

cron_expression:cron表达式

 

Ø  表qrtz_scheduler_state:存储集群中note实例信息，quartz会定时读取该表的信息判断集群中每个实例的当前状态

instance_name:之前配置文件中org.quartz.scheduler.instanceId配置的名字，就会写入该字段，如果设置为AUTO,quartz会根据物理机名和当前时间产生一个名字

last_checkin_time:上次检查时间

checkin_interval:检查间隔时间

3.3      配置文件

配置quartz.properties文件：

#调度标识名 集群中每一个实例都必须使用相同的名称

org.quartz.scheduler.instanceName= scheduler

#ID设置为自动获取 每一个必须不同

org.quartz.scheduler.instanceId= AUTO

#数据保存方式为持久化

org.quartz.jobStore.class =org.quartz.impl.jdbcjobstore.JobStoreTX

#数据库平台

org.quartz.jobStore.driverDelegateClass= org.quartz.impl.jdbcjobstore.StdJDBCDelegate  

#数据库别名 随便取

org.quartz.jobStore.dataSource= myXADS

#表的前缀

org.quartz.jobStore.tablePrefix= QRTZ_

#设置为TRUE不会出现序列化非字符串类到 BLOB 时产生的类版本问题

org.quartz.jobStore.useProperties= true

#加入集群

org.quartz.jobStore.isClustered= true

#调度实例失效的检查时间间隔

org.quartz.jobStore.clusterCheckinInterval= 20000

#容许的最大作业延长时间

org.quartz.jobStore.misfireThreshold= 60000

#ThreadPool 实现的类名

org.quartz.threadPool.class= org.quartz.simpl.SimpleThreadPool

#线程数量

org.quartz.threadPool.threadCount= 10

#线程优先级

org.quartz.threadPool.threadPriority= 5

#自创建父线程

org.quartz.threadPool.threadsInheritContextClassLoaderOfInitializingThread= true

3.4      Cron表达式

一个cron表达式有至少6个（也可能7个）有空格分隔的时间元素。

按顺序依次为

秒（0~59）

分钟（0~59）

小时（0~23）

天（月）（0~31，但是你需要考虑你月的天数）

月（0~11）

天（星期）（1~7 1=SUN 或 SUN，MON，TUE，WED，THU，FRI，SAT）

年份（1970－2099）

这个只需要理解就可以了，我一般都是在线自动生成http://cron.qqe2.com/

4        总结

使用quartz集群配置个人体验的体验，以下供参考

优点：

1、执行计划灵活配置通过cron表达式+工作日历，一般能保证执行的规则灵活多变；

2、集群式管理，可以保证多节点工作的时候，同一任务只有一个节点在执行，并且如果执行失败或宕机，通过集群配置，自动负载找到最优节点去完成没有完成的任务；

3、通过quartz已经集成好的方法，扩展实际的外部实现功能接口，灵活的管理任务，创建、执行、暂停、删除、修改等；

4、集成好的数据库中，通过手写查看方法，可以查询各个任务的执行状态，包括下一执行时间等信息。

5、结构清晰，我的应用中只需要定一个枚举类型，然后去写它的执行方法就可以了

注意：

1、设置间隔的时候要注意不要小于该任务的执行最长时间，否则的话虽然不会多个任务同时执行，但有可能导致不按cron表达式执行