Quartz在Spring中集群

概述

虽然单个Quartz实例能给予你很好的Job调度能力，但它不能满足典型的企业需求，如可伸缩性、高可靠性满足。假如你需要故障转移的能力并能运行日益增多的 Job，Quartz集群势必成为你应用的一部分了。使用 Quartz 的集群能力可以更好的支持你的业务需求，并且即使是其中一台机器在最糟的时间崩溃了也能确保所有的 Job 得到执行。

Quartz 中集群如何工作

一个 Quartz 集群中的每个节点是一个独立的 Quartz 应用，它又管理着其他的节点。意思是你必须对每个节点分别启动或停止。不像许多应用服务器的集群，独立的 Quartz 节点并不与另一其的节点或是管理节点通信。Quartz 应用是通过数据库表来感知到另一应用的。

图：表示了每个节点直接与数据库通信，若离开数据库将对其他节点一无所知


创建Quartz数据库表

因为Quartz 集群依赖于数据库，所以必须首先创建Quartz数据库表。Quartz 包括了所有被支持的数据库平台的 SQL 脚本。在 <quartz_home>/docs/dbTables 目录下找到那些 SQL 脚本，这里的 <quartz_home> 是解压 Quartz 分发包后的目录。
这里采用的Quartz 2.2.1版本，总共11张表，不同版本，表个数可能不同。数据库为mysql，用tables_mysql_innodb.sql创建数据库表。

配置数据库连接池

1.配置jdbc.properties文件

 

Xml代码  

1. jdbc.driverClassName=com.mysql.jdbc.Driver  
2. jdbcjdbc.url=jdbc:mysql://localhost:3306/quartz?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true  
3. jdbc.username=root  
4. jdbc.password=kfs  

 
2.配置applicationContext.xml文件

 

 

Xml代码  

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <beans xmlns="http://www.springframework.org/schema/beans"  
3.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:jdbc="http://www.springframework.org/schema/jdbc"  
4.     xmlns:context="http://www.springframework.org/schema/context"  
5.     xsi:schemaLocation="     
6.     http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd  
7.    http://www.springframework.org/schema/jdbc http://www.springframework.org/schema/jdbc/spring-jdbc.xsd  
8.    http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd  
9.    ">  
10.   
11.     <context:component-scan base-package="com.sundoctor" />  
12.   
13.     <!-- 属性文件读入 -->  
14.     <bean id="propertyConfigurer"  
15.         class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">  
16.         <property name="locations">  
17.             <list>  
18.                 <value>classpath:jdbc.properties</value>  
19.             </list>  
20.         </property>  
21.     </bean>  
22.   
23.   
24.     <!-- 数据源定义,使用c3p0 连接池 -->  
25.     <bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource"  
26.         destroy-method="close">  
27.         <property name="driverClass" value="${jdbc.driverClassName}" />  
28.         <property name="jdbcUrl" value="${jdbc.url}" />  
29.         <property name="user" value="${jdbc.username}" />  
30.         <property name="password" value="${jdbc.password}" />  
31.         <property name="initialPoolSize" value="${cpool.minPoolSize}" />  
32.         <property name="minPoolSize" value="${cpool.minPoolSize}" />  
33.         <property name="maxPoolSize" value="${cpool.maxPoolSize}" />  
34.         <property name="acquireIncrement" value="${cpool.acquireIncrement}" />  
35.         <property name="maxIdleTime" value="${cpool.maxIdleTime}" />  
36.     </bean>  
37. </beans>  

 

 

 

创建Job测试服务类

Java代码  

1. package com.sundoctor.quartz.cluster.example;  
2.   
3. import java.io.Serializable;  
4.   
5. import org.slf4j.Logger;  
6. import org.slf4j.LoggerFactory;  
7. import org.springframework.stereotype.Service;  
8.   
9.   
10. @Service("simpleService")  
11. public class SimpleService {  
12.       
13.     private static final long serialVersionUID = 122323233244334343L;  
14.     private static final Logger logger = LoggerFactory.getLogger(SimpleService.class);  
15.       
16.     public void testMethod1(){  
17.         //这里执行定时调度业务  
18.         logger.info("testMethod1.......1");  
19.     }  
20.       
21.     public void testMethod2(){  
22.         logger.info("testMethod2.......2");   
23.     }  
24. }  

 

 

 

创建两个Job类MyQuartzJobBean1、MyQuartzJobBean2

 

Java代码  

1. package com.sundoctor.quartz.cluster.example;  
2.   
3. import org.quartz.DisallowConcurrentExecution;  
4. import org.quartz.JobExecutionContext;  
5. import org.quartz.JobExecutionException;  
6. import org.quartz.PersistJobDataAfterExecution;  
7. import org.quartz.SchedulerException;  
8. import org.slf4j.Logger;  
9. import org.slf4j.LoggerFactory;  
10. import org.springframework.context.ApplicationContext;  
11. import org.springframework.scheduling.quartz.QuartzJobBean;  
12.   
13. @PersistJobDataAfterExecution  
14. @DisallowConcurrentExecution// 不允许并发执行  
15. public class MyQuartzJobBean1 extends QuartzJobBean {  
16.   
17.     private static final Logger logger = LoggerFactory.getLogger(MyQuartzJobBean1.class);  
18.   
19.     @Override  
20.     protected void executeInternal(JobExecutionContext jobexecutioncontext) throws JobExecutionException {  
21.   
22.         SimpleService simpleService = getApplicationContext(jobexecutioncontext).getBean("simpleService",  
23.                 SimpleService.class);  
24.         simpleService.testMethod1();  
25.   
26.     }  
27.   
28.     private ApplicationContext getApplicationContext(final JobExecutionContext jobexecutioncontext) {  
29.         try {  
30.             return (ApplicationContext) jobexecutioncontext.getScheduler().getContext().get("applicationContextKey");  
31.         } catch (SchedulerException e) {  
32.             logger.error("jobexecutioncontext.getScheduler().getContext() error!", e);  
33.             throw new RuntimeException(e);  
34.         }  
35.     }  
36.   
37. }  

 

配置 Quartz 使用集群

1.配置节点的 quartz.properties 文件

引用

org.quartz.scheduler.instanceName = TestScheduler1   
org.quartz.scheduler.instanceId = AUTO  

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.impl.jdbcjobstore.JobStoreTX
org.quartz.jobStore.driverDelegateClass=org.quartz.impl.jdbcjobstore.StdJDBCDelegate
org.quartz.jobStore.tablePrefix = QRTZ_
org.quartz.jobStore.maxMisfiresToHandleAtATime=10
org.quartz.jobStore.isClustered = true  
org.quartz.jobStore.clusterCheckinInterval = 20000

org.quartz.scheduler.instanceName属性可为任何值，用在 JDBC JobStore 中来唯一标识实例，但是所有集群节点中必须相同。

org.quartz.scheduler.instanceId　属性为 AUTO即可，基于主机名和时间戳来产生实例 ID。

org.quartz.jobStore.class属性为 JobStoreTX，将任务持久化到数据中。因为集群中节点依赖于数据库来传播 Scheduler 实例的状态，你只能在使用 JDBC JobStore 时应用 Quartz 集群。这意味着你必须使用 JobStoreTX 或是 JobStoreCMT 作为 Job 存储；你不能在集群中使用 RAMJobStore。

org.quartz.jobStore.isClustered 属性为 true，你就告诉了 Scheduler 实例要它参与到一个集群当中。这一属性会贯穿于调度框架的始终，用于修改集群环境中操作的默认行为。

org.quartz.jobStore.clusterCheckinInterval 属性定义了Scheduler 实例检入到数据库中的频率(单位：毫秒)。Scheduler 检查是否其他的实例到了它们应当检入的时候未检入；这能指出一个失败的 Scheduler 实例，且当前 Scheduler 会以此来接管任何执行失败并可恢复的 Job。通过检入操作，Scheduler 也会更新自身的状态记录。clusterChedkinInterval 越小，Scheduler 节点检查失败的 Scheduler 实例就越频繁。默认值是 15000 (即15 秒)。

2.配置applicationContext-quartz.xml文件

 

Xml代码  

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <beans xmlns="http://www.springframework.org/schema/beans"  
3.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
4.     xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">  
5.   
6.     <bean name="quartzScheduler"  
7.         class="org.springframework.scheduling.quartz.SchedulerFactoryBean">  
8.         <property name="dataSource">  
9.             <ref bean="dataSource" />  
10.         </property>  
11.         <property name="applicationContextSchedulerContextKey" value="applicationContextKey" />  
12.         <property name="configLocation" value="classpath:quartz.properties" />          
13.         <property name="triggers">  
14.             <list>  
15.                 <ref bean="trigger1" />  
16.                 <ref bean="trigger2" />  
17.             </list>  
18.         </property>  
19.     </bean>  
20.   
21.     <bean id="jobDetail1" class="org.springframework.scheduling.quartz.JobDetailFactoryBean">  
22.         <property name="jobClass">  
23.             <value>com.sundoctor.quartz.cluster.example.MyQuartzJobBean1</value>  
24.         </property>     
25.         <property name="durability" value="true" />     
26.         <property name="requestsRecovery" value="true" />       
27.     </bean>  
28.     <bean id="trigger1" class="org.springframework.scheduling.quartz.CronTriggerFactoryBean">  
29.         <property name="jobDetail" ref="jobDetail1" />  
30.         <property name="cronExpression" value="0/30 * * ? * * *" />  
31.     </bean>  
32.   
33.     <bean id="jobDetail2" class="org.springframework.scheduling.quartz.JobDetailFactoryBean">  
34.         <property name="jobClass">  
35.             <value>com.sundoctor.quartz.cluster.example.MyQuartzJobBean2</value>  
36.         </property>     
37.         <property name="durability" value="true" />     
38.         <property name="requestsRecovery" value="true" />       
39.     </bean>  
40.     <bean id="trigger2" class="org.springframework.scheduling.quartz.CronTriggerFactoryBean">  
41.         <property name="jobDetail" ref="jobDetail2" />  
42.         <property name="cronExpression" value="0/10 * * ? * * *" />  
43.     </bean>     
44.   
45. </beans>  

 

 

dataSource：项目中用到的数据源，里面包含了quartz用到的11张数据库表；

applicationContextSchedulerContextKey： 是org.springframework.scheduling.quartz.SchedulerFactoryBean这个类中把spring上下 文以key/value的方式存放在了SchedulerContext中了，可以用applicationContextSchedulerContextKey所 定义的key得到对应spring 的ApplicationContext； 

configLocation：用于指明quartz的配置文件的位置

requestsRecovery
requestsRecovery属性必须设置为 true，当Quartz服务被中止后，再次启动或集群中其他机器接手任务时会尝试恢复执行之前未完成的所有任务。

运行Quartz集群

在相同或不同的机器上运行com.sundoctor.quartz.cluster.example.test.MainTest进行测试，在本例中只是简单打印一下日志。

Java代码  

1. package com.sundoctor.quartz.cluster.example.test;  
2.   
3. import org.springframework.context.ApplicationContext;  
4. import org.springframework.context.support.ClassPathXmlApplicationContext;  
5.   
6. public class MainTest {  
7.   
8.     /** 
9.      * @param args 
10.      */  
11.     public static void main(String[] args) {  
12.         ApplicationContext springContext = new ClassPathXmlApplicationContext(new String[]{"classpath:applicationContext.xml","classpath:applicationContext-quartz.xml"});  
13.     }  
14.   
15. }  

Quartz 实际并不关心你是在相同的还是不同的机器上运行节点。当集群是放置在不同的机器上时，通常称之为水平集群。节点是跑在同一台机器是，称之为垂直集群。对于垂直集群，存在着单点故障的问题。这对高可用性的应用来说是个坏消息，因为一旦机器崩溃了，所有的节点也就被有效的终止了。

当你运行水平集群时，时钟应当要同步，以免出现离奇且不可预知的行为。假如时钟没能够同步，Scheduler 实例将对其他节点的状态产生混乱。有几种简单的方法来保证时钟何持同步，而且也没有理由不这么做。最简单的同步计算机时钟的方式是使用某一个 Internet 时间服务器(Internet Time Server ITS)。

没什么会阻止你在相同环境中使用集群的和非集群的 Quartz 应用。唯一要注意的是这两个环境不要混用在相同的数据库表。意思是非集群环境不要使用与集群应用相同的一套数据库表；否则将得到希奇古怪的结果，集群和非集群的 Job 都会遇到问题。

假如你让一个非集群的 Quartz 应用与集群节点并行着运行，设法使用 JobInitializationPlugin和 RAMJobStore。