Quartz入门-用xml实现日程安排.

Quartz入门-用xml实现日程安排.

Author :Meanson Wang
Email:[email protected]
Date:2004-12-12


Section 01 : Why Quartz
Quartz是企业级的日程安排[schedule]软件，有UNIX下熟悉的CRON定义方式,也有简单的定义方式。
Quartz的存储方式可以是内存存储，也可以用数据库来实现持久化。

Section 02:Why this article
使用Quartz的过程中发现入门的文章很少，看Quartz的文档是很痛苦的事情，因为你希望下午就可以交差的东东，却发现它连Quick Start都没有，除了郁闷，你别无他法。
这篇文章是实战型，直接介绍如何可以最快使用上Quartz，起码，替代timer.

Section 03:How to start ...
本文介绍的是用xml启动Quartz任务的方法。

1.下载Quartz
将quartz放到 yourappl/WEB-INF/lib 里面。
2.配置web.xml,启动Quartz服务.
在 yourappl/WEB-INF/web.xml 里添加以下内容。


  QuartzInitializer
  Quartz Initializer Servlet
  org.quartz.ee.servlet.QuartzInitializerServlet
  1


3.配置您的任务文件 quartz_reminder.xml ,建立job 和 trigger.
在 yourappl/WEB-INF/web.xml 里新建文件 quartz_reminder.xml
以下例子建立两个日程安排，一个是每隔15分钟执行scheduling.QuartzEmail任务，
一个是星期1-5 8：30AM执行scheduling.QuartzDailyReminder任务。您可以自建QuartzEmail.class,QuartzDailyReminder.class放置在 yourappl/WEB-INF/classes/scheduling 里进行测试。
注意一个日程是由一个job和一个trigger组成，代表任务定义和时间定义。


    "-//Quartz Enterprise Job Scheduler//DTD Job Scheduling Data 1.0//EN"
  "http://www.quartzscheduler.org/dtd/job_scheduling_data_1_0.dtd">

 
   
      Job_Email
      DEFAULT
      scheduling.QuartzEmail
   
   
     
        Trigger_Email
        DEFAULT
        Job_Email
        DEFAULT
        0 0/15 * * * ?cron-expression>
    
   
 
 
   
      Job_Daily_Reminder
      DEFAULT
      scheduling.QuartzDailyReminder
   
   
     
        Trigger_Daily_Reminder
        DEFAULT
        Job_Daily_Reminder
        DEFAULT
        0 30 8 ? * MON-FRI
    
   
 
 


4. 配置 quartz.properties ，建立Quartz实例
在 yourappl/WEB-INF/web.xml 里新建文件 quartz.properties
#
# Configure Main Scheduler Properties
#

org.quartz.scheduler.instanceName = TestScheduler
org.quartz.scheduler.instanceId = one

#
# Configure ThreadPool
#

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

#
# Configure JobStore
#

org.quartz.jobStore.misfireThreshold = 5000

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

# ===========================================================================
# Configure SchedulerPlugins  ===============================================
# ===========================================================================
org.quartz.plugin.triggHistory.class = org.quartz.plugins.history.LoggingTriggerHistoryPlugin
org.quartz.plugin.triggHistory.triggerFiredMessage = Trigger {1}.{0} fired job {6}.{5} at: {4, date, HH:mm:ss MM/dd/yyyy}
org.quartz.plugin.triggHistory.triggerCompleteMessage = Trigger {1}.{0} completed firing job {6}.{5} at {4, date, HH:mm:ss MM/dd/yyyy} with resulting trigger instruction code: {9}

org.quartz.plugin.jobInitializer.class = org.quartz.plugins.xml.JobInitializationPlugin
org.quartz.plugin.jobInitializer.fileName = /quartz_reminder.xml
org.quartz.plugin.jobInitializer.overWriteExistingJobs = false
org.quartz.plugin.jobInitializer.failOnFileNotFound = true

org.quartz.plugin.shutdownhook.class = org.quartz.plugins.management.ShutdownHookPlugin
org.quartz.plugin.shutdownhook.cleanShutdown = true

好了，现在重起jsp服务器，留意logs里面的输出，就可以测试您的日程有无生效了。


后记：2004-12-20
Quartz对所有相关的XML文件都用以下的文件头：
    "-//Quartz Enterprise Job Scheduler//DTD Job Scheduling Data 1.0//EN"
  "http://www.quartzscheduler.org/dtd/job_scheduling_data_1_0.dtd">
它用dtd文件对XML文件进行解析。这不是问题，问题是，这个dtd文件被放在Quartz的网站上，如果您的服务器不能访问Internet,你的Quartz就不能正常工作了。
解决办法：
1.把quartz1.4.2.zip里面docs的dtd文件夹拷贝到你的应用yourappl里面。
2.修改XML文件的文件头为:
    "-//Quartz Enterprise Job Scheduler//DTD Job Scheduling Data 1.0//EN"
  "http://127.0.0.1:8080/yourappl/dtd/job_scheduling_data_1_0.dtd">
3.输入绝对路径也是可以的，如“/tomcat/yourappl/dtd/job_scheduling_data_1_0.dtd“

附：cronExpression配置说明

字段		允许值		允许的特殊字符
秒		0-59		, - * /
分		0-59		, - * /
小时		0-23		, - * /
日期		1-31		, - * ? / L W C
月份		1-12 或者 JAN-DEC		, - * /
星期		1-7 或者 SUN-SAT		, - * ? / L C #
年（可选）		留空, 1970-2099		, - * /