Spring中定时任务Quartz集群配置学习

Spring中定时任务Quartz集群配置学习

原来配置的Quartz是通过spring配置文件生效的，发现在非集群式的服务器上运行良好，但是将工程部署到水平集群服务器上去后改定时功能不能正常运行，没有任何错误日志，于是从jar包、JDK版本、cronExpression到服务器类型，甚至查到了服务器操作系统的类型，都没能找到解决的办法，后来才知道是集群惹的祸！

详细步骤如下：

1、 按照Quartz集群工作原理

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

在数据库中建表。建表模版在Quartz包下docs/dbTables下，选择相应的数据库和版本即可。ORACLE的11个Table列表如下：

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

•  JOB_NAME
•  JOB_GROUP
•  JOB_LISTENER

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

QRTZ_FIRED_TRIGGERS：存储与已触发的 Trigger 相关的状态信息，以及相联 Job的执行信息

QRTZ_PAUSED_TRIGGER_GRPS：存储已暂停的 Trigger 组的信息

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

•  INSTANCE_NAME 之前配置文件中 org.quartz.scheduler.instanceId 配置的名字，就会写入该字段，如果设置为 AUTO,quartz 会根据物理机名和当前时间产生一个名字
•  LAST_CHECKIN_TIME：上次检查时间
•  CHECKIN_INTERVAL ：检查间隔时间

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

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

•  TRIGGER_NAME ：qrtz_triggers 表 trigger_name 的外键
•  TRIGGER_GROUP：qrtz_triggers 表 trigger_group 的外键
•  REPEAT_COUNT ：重复次数
•  REPEAT_INTERVAL：时间间隔
•  TIMES_TRIGGERED：触发次数

QRTZ_CRON_TRIGGERS：存储cron表达式表

•  TRIGGER_NAME ：qrtz_triggers 表 trigger_name 的外键
•  TRIGGER_GROUP：qrtz_triggers 表 trigger_group 的外键 
•  CRON_EXPRESSION：cron 表达式
•  TIME_ZONE_ID ：时区

QRTZ_TRIGGERS：保存trigger信息

•  TRIGGER_NAME ：trigger 的名字 , 该名字用户自己可以随意定制 , 无强行要求
•  TRIGGER_GROUP：所属组的名字 , 该名字用户自己随意定制 , 无强行要求
•  JOB_NAME ：qrtz_job_details 表 job_name 的外键
•  JOB_GROUP ：qrtz_job_details 表 job_group 的外键
•  IS_VOLATILE 0
•  DESCRIPTION
•  NEXT_FIRE_TIME
•  PREV_FIRE_TIME
•  PRIORITY 5
•  TRIGGER_STATE ：当前 trigger 状态，设置为 ACQUIRED, 如果设置为 WAITING, 则 job 不会触发
•  TRIGGER_TYPE：触发器类型 , 使用 cron 表达式
•  START_TIME
•  END_TIME
•  CALENDAR_NAME
•  MISFIRE_INSTR
•  JOB_DATA

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

•  JOB_NAME ：集群中 job 的名字 , 该名字用户自己可以随意定制 , 无强行要求
•  JOB_GROUP ：集群中 job 的所属组的名字 , 该名字用户自己随意定制 , 无强行要求 
•  DESCRIPTION
•  JOB_CLASS_NAME：集群中个 note job 实现类的完全包名 ,quartz 就是根据这个路径到 classpath 找到该 job 类 
•  IS_DURABLE：是否持久化 , 把该属性设置为 1 ， quartz 会把 job 持久化到数据库中
•  IS_VOLATILE
•  IS_STATEFUL
•  REQUESTS_RECOVERY
•  JOB_DATA ：一个 blob 字段，存放持久化 job 对象

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

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

•  TRIGGER_NAME ：qrtz_triggers 表 trigger_name 的外键
•  TRIGGER_GROUP：qrtz_triggers 表 trigger_group 的外键 
•  BLOB_DATA

2、 配置数据库连接池，如果spring已经配置则不需要再另行配置，只需在后面配置的applicationContext-quartz.xml引入即可。

applicationContext.xml：

<bean id="propertyConfigurer" 

class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer"> 

<property name="location"> 

<value>classpath:dataConfig.properties</value> 

</property> 

</bean> 

 <bean id="ds34" class="org.apache.commons.dbcp.BasicDataSource" 

 destroy-method="close"> 

 <property name="driverClassName"> 

 <value>${ds34.driver}</value> 

 </property> 

 <property name="url"> 

 <value>${ds34.url}</value> 

 </property> 

 <property name="username"> 

 <value>${ds34.username}</value> 

 </property> 

 <property name="password"> 

 <value>${ds34.password}</value> 

 </property> 

 <property name="maxActive" value="5"></property> 

 <property name="maxIdle" value="20"></property> 

 <property name="maxWait" value="50"></property> 

 <property name="defaultAutoCommit" value="true"></property> 

</bean>

dataConfig.properties：

jdbc.driverClassName=oracle.jdbc.driver.OracleDriver

jdbc.url=jdbc:oracle:thin:@localhost:1521:test

jdbc.username=test

jdbc.password=test

3、 配置quartz.properties

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

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

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

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

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

quartz.properties：

##Quartz 调度任务所需的配置文件 

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

org.quartz.scheduler.instanceName = HumsScheduler 

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

org.quartz.scheduler.instanceId = AUTO 

orgorg.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属性为 JobStoreTX，将任务持久化到数据中。 

##因为集群中节点依赖于数据库来传播 Scheduler 实例的状态，你只能在使用 JDBC JobStore 时应用 Quartz 集群。 

##这意味着你必须使用 JobStoreTX 或是 JobStoreCMT 作为 Job 存储；你不能在集群中使用 RAMJobStore。 

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

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

org.quartz.jobStore.tablePrefix = QRTZ_ 

org.quartz.jobStore.maxMisfiresToHandleAtATime=10 

##org.quartz.jobStore.isClustered 属性为 true，你就告诉了 Scheduler 实例要它参与到一个集群当中。 

##这一属性会贯穿于调度框架的始终，用于修改集群环境中操作的默认行为。 

org.quartz.jobStore.isClustered = true 

##org.quartz.jobStore.clusterCheckinInterval 属性定义了Scheduler 实例检入到数据库中的频率(单位：毫秒)。 

##Scheduler 检查是否其他的实例到了它们应当检入的时候未检入；这能指出一个失败的 Scheduler 实例，且当前 Scheduler 会以此来接管任何执行失败并可恢复的 Job。 

##通过检入操作，Scheduler 也会更新自身的状态记录。clusterChedkinInterval 越小，Scheduler 节点检查失败的 Scheduler 实例就越频繁。默认值是 15000 (即15 秒)。 

org.quartz.jobStore.clusterCheckinInterval = 20000

4、 配置applicationContext-quartz.xml

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN 2.0//EN" "http://www.springframework.org/dtd/spring-beans-2.0.dtd">

<beans>

    <bean name="quartzScheduler" class="org.springframework.scheduling.quartz.SchedulerFactoryBean">

        <property name="dataSource">

            <ref bean="dataSource"/>

        </property>

        <property name="applicationContextSchedulerContextKey" value="applicationContextKey"/>

        <property name="configLocation" value="classpath:quartz.properties"/>

<property name="triggers">

<list>   

<ref bean="trigger1"/>

<!-- 

<ref bean="trigger2"/>

 -->      

</list>

</property>

    </bean> 

    <bean id="jobDetail1" class="frameworkx.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">

        <property name="targetObject" ref="simpleService"/>

        <property name="targetMethod" value="testMethod1"/>

<property name="shouldRecover" value="true"/>

    </bean>

    <bean id="trigger1" class="org.springframework.scheduling.quartz.CronTriggerBean">

        <property name="jobDetail" ref="jobDetail1"/>

        <property name="cronExpression" value="* 0/1 * ? * * *"/>

    </bean>    

  <!--  

    <bean id="jobDetail2" class="frameworkx.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">

        <property name="targetObject" ref="simpleService"/>

        <property name="targetMethod" value="testMethod2"/>

<property name="shouldRecover" value="true"/>

    </bean>

    <bean id="trigger2" class="org.springframework.scheduling.quartz.SimpleTriggerBean">

        <property name="jobDetail" ref="jobDetail2"/>

        <property name="startDelay" value="1"/>

        <property name="repeatCount" value="100"/>

        <property name="repeatInterval" value="1000"/>

    </bean>

   -->

</beans>

5、 配置Job任务注意：加入定时任务有两种方式：

① 继承QuartzJobBean的类，重写executeInternal()，详细写法：

<bean id="jobDetail1" class="org.springframework.scheduling.quartz.JobDetailBean">
 <property name="jobClass">
 <value>继承QuartzJobBean的类的引用</value>
 </property>
</bean>

②用org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean指定类和方法，但是直接使用会报java.io.NotSerializableException异常，一般用网上流传的（需要将两个类copy到自己的工程下，要有springJAR包，Job需要持久化到数据库中，SimpleService必须实现Serializable）frameworkx.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean。详细写法：

<bean id="jobDetail1" class=" 工程里MethodInvokingJobDetailFactoryBean的路径.MethodInvokingJobDetailFactoryBean"> 

<property name="targetObject" ref="simpleService"/> 

<property name="targetMethod" value="testMethod1"/> 

<property name="shouldRecover" value="true"/> 

</bean>

6、 配置到spring配置文件，自动调度任务。

<import resource="applicationContext-quartz.xml"></import>

7、 测试用例

public class MainTest {

/**

 * @param args

 */

public static void main(String[] args) {

ApplicationContext springContext = new ClassPathXmlApplicationContext(new String[]{"classpath:applicationContext.xml"});

}

}