总结几点Quartz的经验

总结一下经典的定时处理框架quartz的使用经验。基于 Ver. 1.8.0

  1.配置方式

        最常用的方式properties + xml定义

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

org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPool
org.quartz.threadPool.threadCount = 5
org.quartz.threadPool.threadPriority = 5

org.quartz.jobStore.misfireThreshold = 60000
org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore

org.quartz.plugin.triggHistory.class = org.quartz.plugins.history.LoggingJobHistoryPlugin

org.quartz.plugin.jobInitializer.class = org.quartz.plugins.xml.XMLSchedulingDataProcessorPlugin
org.quartz.plugin.jobInitializer.fileNames = quartz_data.xml
org.quartz.plugin.jobInitializer.failOnFileNotFound = true

#默认会联网检查是否有更新，还是skip为好
org.quartz.scheduler.skipUpdateCheck = true

org.quartz.scheduler.instanceName = CMS_Batch

org.quartz.scheduler.instanceId = AUTO



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

org.quartz.threadPool.threadCount = 5

org.quartz.threadPool.threadPriority = 5



org.quartz.jobStore.misfireThreshold = 60000

org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore



org.quartz.plugin.triggHistory.class = org.quartz.plugins.history.LoggingJobHistoryPlugin



org.quartz.plugin.jobInitializer.class = org.quartz.plugins.xml.XMLSchedulingDataProcessorPlugin

org.quartz.plugin.jobInitializer.fileNames = quartz_data.xml

org.quartz.plugin.jobInitializer.failOnFileNotFound = true



#默认会联网检查是否有更新，还是skip为好

org.quartz.scheduler.skipUpdateCheck = true

 

        properties定义全局信息(全局Listener也在这定义)，xml定义Job、trigger信息

<?xml version="1.0" encoding="UTF-8"?>
<job-scheduling-data xmlns="http://www.quartz-scheduler.org/xml/JobSchedulingData"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.quartz-scheduler.org/xml/JobSchedulingData http://www.quartz-scheduler.org/xml/job_scheduling_data_1_8.xsd"
    version="1.8">

    <pre-processing-commands>
        <delete-jobs-in-group>*</delete-jobs-in-group>  <!-- clear all jobs in scheduler -->
        <delete-triggers-in-group>*</delete-triggers-in-group> <!-- clear all triggers in scheduler -->
    </pre-processing-commands>

    <processing-directives>
        <overwrite-existing-data>true</overwrite-existing-data>
        <ignore-duplicates>false</ignore-duplicates>
    </processing-directives>

    <schedule>
        <job>
            <name>FooJob</name>
            <group>FooBatch</group>
            <description>定时运行Job</description>
            <job-class>xxx.yyy.FooJob</job-class>
            <volatility>false</volatility>
            <durability>true</durability>
            <recover>false</recover>
        </job>
        <trigger>
            <cron>
                <name>FooTrigger</name>
                <group>FooBatch</group>
                <job-name>FooJob</job-name>
                <job-group>FooBatch</job-group>
                <misfire-instruction>MISFIRE_INSTRUCTION_FIRE_ONCE_NOW</misfire-instruction>
                <cron-expression>30/15 * 13 * * ?</cron-expression>
                <!-- 秒 分 时 日 月 星期 年 -->
            </cron>
        </trigger>
        <job>
            <name>barJob</name>
            <group>FooBatch</group>
            <description>无trigger的Job</description>
            <job-class>xxx.yyy.barJob</job-class>
            <volatility>false</volatility>
            <durability>true</durability>
            <recover>false</recover>
        </job>
    </schedule>
</job-scheduling-data>

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

<job-scheduling-data xmlns="http://www.quartz-scheduler.org/xml/JobSchedulingData"

    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

    xsi:schemaLocation="http://www.quartz-scheduler.org/xml/JobSchedulingData http://www.quartz-scheduler.org/xml/job_scheduling_data_1_8.xsd"

    version="1.8">

    

    <pre-processing-commands>

        <delete-jobs-in-group>*</delete-jobs-in-group>  <!-- clear all jobs in scheduler -->

        <delete-triggers-in-group>*</delete-triggers-in-group> <!-- clear all triggers in scheduler -->

    </pre-processing-commands>

    

    <processing-directives>

        <overwrite-existing-data>true</overwrite-existing-data>

        <ignore-duplicates>false</ignore-duplicates> 

    </processing-directives>

    

    <schedule>

	    <job>

	        <name>FooJob</name>

            <group>FooBatch</group>

            <description>定时运行Job</description>

	        <job-class>xxx.yyy.FooJob</job-class>

	        <volatility>false</volatility>

            <durability>true</durability>

            <recover>false</recover>

	    </job>

	    <trigger>

	        <cron>

	            <name>FooTrigger</name>

	            <group>FooBatch</group>

	            <job-name>FooJob</job-name>

	            <job-group>FooBatch</job-group>

                <misfire-instruction>MISFIRE_INSTRUCTION_FIRE_ONCE_NOW</misfire-instruction>

	            <cron-expression>30/15 * 13 * * ?</cron-expression>

                <!-- 秒 分 时 日 月 星期 年 -->

	        </cron>

	    </trigger>

	    <job>

	        <name>barJob</name>

            <group>FooBatch</group>

            <description>无trigger的Job</description>

	        <job-class>xxx.yyy.barJob</job-class>

	        <volatility>false</volatility>

            <durability>true</durability>

            <recover>false</recover>

	    </job>

    </schedule>    

</job-scheduling-data>

 

        与J2ee容器结合，提供QuartzInitializerListener，可设定随容器自动启动，这个很方便

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://java.sun.com/xml/ns/j2ee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.4"
    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
    http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">

  <display-name>Foo Batch</display-name>

  <context-param>
    <param-name>quartz:config-file</param-name>
    <param-value>/quartz.properties</param-value>
  </context-param>

  <listener>
    <listener-class>
       org.quartz.ee.servlet.QuartzInitializerListener
    </listener-class>
  </listener>

  </web-app>

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

<web-app xmlns="http://java.sun.com/xml/ns/j2ee"

	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.4"

	xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee 

	http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">



  <display-name>Foo Batch</display-name>



  <context-param>

    <param-name>quartz:config-file</param-name>

    <param-value>/quartz.properties</param-value>

  </context-param>



  <listener>

    <listener-class>

       org.quartz.ee.servlet.QuartzInitializerListener

    </listener-class>

  </listener>



  </web-app>

 

 

  2.Job、Trigger、Listener

        Job需要由Trigger启动，可以有多个Listener

        Trigger同样可以有多个Listener

 

  3.有待改进的地方

       Trigger不完善，只提供了“定时”Trigger，其他诸如基于Job完成与否或完成状态的Trigger需要自己靠Listener实现。

       配置不完善，配置文件只提供全局Listener定义，针对Job或Trigger的Listener要程序添加，另外1.8版本在配置无Trigger的Job时有bug(XMLSchedulingDataProcessor 1015行需要nullcheck)，直接导致xml解析错误，感觉这自带的plugin还很简陋。

       plugin和Job同级别 ，（这个说法有点偏颇，但是产生的效果类似）这意味着在schedule启动前是不会解析配置文件的，只能在启动后调整Job等等内容，同时scheduler.getJobDetail取的Job是通过clone方式取得的，任何对Job的修改都无效...这个很无语 （clone的方式还是有道理的，已经设置好的Job不能随便改动）

scheduler.start(); //启动后读取配置文件等等

JobDetail fooJob = scheduler.getJobDetail("FooJob",
        "FooBatch");

fooJob.addJobListener(someListener);

//取Job对应的Trigger
Trigger[] triggers = scheduler.getTriggersOfJob(fooJob.getName(),
        fooJob.getGroup());

scheduler.addJob(fooJob, true); //true指明替换已有Job（没有关联Trigger）

//清除旧Trigger，重新建立Job和Trigger关联
for (Trigger trigger : triggers) {
    scheduler.rescheduleJob(trigger.getName(), trigger.getGroup(), trigger);
}

scheduler.start(); //启动后读取配置文件等等



JobDetail fooJob = scheduler.getJobDetail("FooJob",

        "FooBatch");



fooJob.addJobListener(someListener);



//取Job对应的Trigger

Trigger[] triggers = scheduler.getTriggersOfJob(fooJob.getName(),

        fooJob.getGroup());



scheduler.addJob(fooJob, true); //true指明替换已有Job（没有关联Trigger）



//清除旧Trigger，重新建立Job和Trigger关联

for (Trigger trigger : triggers) {

    scheduler.rescheduleJob(trigger.getName(), trigger.getGroup(), trigger);

} 

 

 

摘自http://foxswily.iteye.com/blog/683007