JAVA+tomcat+quartz

在配置quartz定时时，
使用quartz_job.xml配置文件时发生错误

java.lang.NoClassDefFoundError:   javax/transaction/UserTransaction
原来是缺少jta.jar包

用quartz时需要两个基本的JAR包：quartz-1.6.1.jar和jta.jar


在web环境下，Quartz可以通过配置文件来完成后台的作业调度，不必手工创建Trigger和Scheduler，其步骤如下：

首先将quartz.jar,以及lib目录下面core和optional两个目录中的所有jar全都放入项目WEB-INF\lib目录下

job就是一个简单的java类，这里的功能就是输出当前的时间了。

import java.util.Date;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.quartz.Job;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;

public class Helloworld implements Job{
public void execute(JobExecutionContext context)
throws JobExecutionException {
JobDetail jobDetail = context.getJobDetail();
String jobName = jobDetail.getName();
System.out.println(jobName + "--------fired at" + new Date());
logger.info(jobName + "-----------fired at" + new Date());
}
}


然后编写quartz.properties文件，这个文件的默认名称就是quartz.properties，如果启动项目的时候，Quartz没有在工程中找到该文件，就会从自己的jar包下面读取其默认的properties文件，其内容如下：

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

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

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_job.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

上面的
org.quartz.plugin.jobInitializer.fileName = quartz_job.xml

是用来配置定义job文件的名称。

然后编写quartz_job.xml，

<?xml version="1.0" encoding="UTF-8"?>
<quartz>
  <job>
    <job-detail>
      <name>helloworld</name>
      <group>group1</group>
      <job-class>Helloworld</job-class>
    </job-detail>
    <trigger>
      <cron>
        <name>test</name>
        <group>group1</group>
        <job-name>helloworld</job-name>
        <job-group>group1</job-group>
        <cron-expression_r_r>0 0/1 * * * ?</cron-expression_r_r>
     </cron>
    </trigger>
  </job>
</quartz>

可以看到，在配置文件中把jobdetail和trigger都作了完整的定义，并组合成一个job。下面，我们把上面两个文件都放入/WEB-INF/classes目录下，然后按照api中的说明修改一下web.xml。
     <servlet>
         <servlet-name>
             QuartzInitializer
         </servlet-name>
         <display-name>
             Quartz Initializer Servlet
         </display-name>
         <servlet-class>
             org.quartz.ee.servlet.QuartzInitializerServlet
         </servlet-class>
         <load-on-startup>1</load-on-startup>
         <init-param>
             <param-name>config-file</param-name>
             <param-value>/quartz.properties</param-value>
         </init-param>
         <init-param>
             <param-name>shutdown-on-unload</param-name>
             <param-value>true</param-value>
         </init-param>
     </servlet>

这样，在启动Tomcat的时候，QuartzInitializerServlet这个Servlet就会自动读取quartz.properties这个配置文件，并初始化调度信息，启动Scheduler。

现在就大功告成了
一个Job类，一个quartz.properties文件，一个quertz_job.xml文件，还有修改一下web.xml文件，很简单


一个Cron-表达式是一个由六至七个字段组成由空格分隔的字符串，其中6个字段是必须的而一个是可选的，如下：
字段名               允许的值                   允许的特殊字符
秒                        0-59                                   , - * /
分                        0-59                                   , - * /
小时                   0-23                                  , - * /
日                       1-31                                  , - * ? / L W C
月                         1-12 or JAN-DEC              , - * /
周几                   1-7 or SUN-SAT               , - * ? / L C #
年 (可选字段)     empty, 1970-2099            , - * /




''*'' 字符可以用于所有字段，在“分”字段中设为"*"表示"每一分钟"的含义。

''?'' 字符可以用在“日”和“周几”字段. 它用来指定 ''不明确的值''. 这在你需要指定这两个字段中的某一个值而不是另外一个的时候会被用到。在后面的例子中可以看到其含义。

''-'' 字符被用来指定一个值的范围，比如在“小时”字段中设为"10-12"表示"10点到12点".

'','' 字符指定数个值。比如在“周几”字段中设为"MON,WED,FRI"表示"the days Monday, Wednesday, and Friday".

''/'' 字符用来指定一个值的的增加幅度. 比如在“秒”字段中设置为"0/15"表示"第0, 15, 30, 和 45秒"。而 "5/15"则表示"第5, 20, 35, 和 50". 在''/''前加"*"字符相当于指定从0秒开始. 每个字段都有一系列可以开始或结束的数值。对于“秒”和“分”字段来说，其数值范围为0到59，对于“小时”字段来说其为0到23, 对于“日”字段来说为0到31, 而对于“月”字段来说为1到12。"/"字段仅仅只是帮助你在允许的数值范围内从开始"第n"的值。 因此对于“月”字段来说"7/6"只是表示7月被开启而不是“每六个月”, 请注意其中微妙的差别。

''L''字符可用在“日”和“周几”这两个字段。它是"last"的缩写, 但是在这两个字段中有不同的含义。例如,“日”字段中的"L"表示"一个月中的最后一天" —— 对于一月就是31号对于二月来说就是28号（非闰年）。而在“周几”字段中, 它简单的表示"7" or "SAT"，但是如果在“周几”字段中使用时跟在某个数字之后, 它表示"该月最后一个星期×" —— 比如"6L"表示"该月最后一个周五"。当使用''L''选项时,指定确定的列表或者范围非常重要，否则你会被结果搞糊涂的。

''W'' 可用于“日”字段。用来指定历给定日期最近的工作日(周一到周五) 。比如你将“日”字段设为"15W"，意为: "离该月15号最近的工作日"。因此如果15号为周六，触发器会在14号即周五调用。如果15号为周日, 触发器会在16号也就是周一触发。如果15号为周二,那么当天就会触发。然而如果你将“日”字段设为"1W", 而一号又是周六, 触发器会于下周一也就是当月的3号触发,因为它不会越过当月的值的范围边界。''W''字符只能用于“日”字段的值为单独的一天而不是一系列值的时候。

''L''和''W''可以组合用于“日”字段表示为''LW''，意为"该月最后一个工作日"。

''#'' 字符可用于“周几”字段。该字符表示“该月第几个周×”，比如"6#3"表示该月第三个周五( 6表示周五而"#3"该月第三个)。再比如: "2#1" = 表示该月第一个周一而 "4#5" = 该月第五个周三。注意如果你指定"#5"该月没有第五个“周×”，该月是不会触发的。

''C'' 字符可用于“日”和“周几”字段，它是"calendar"的缩写。它表示为基于相关的日历所计算出的值（如果有的话）。如果没有关联的日历, 那它等同于包含全部日历。“日”字段值为"5C"表示"日历中的第一天或者5号以后"，“周几”字段值为"1C"则表示"日历中的第一天或者周日以后"。






对于“月份”字段和“周几”字段来说合法的字符都不是大小写敏感的。

下面是一些完整的例子:
表达式     含义
"0 0 12 * * ?"        每天中午十二点触发
"0 15 10 ? * *"      每天早上10：15触发
"0 15 10 * * ?"       每天早上10：15触发
"0 15 10 * * ? *"     每天早上10：15触发
"0 15 10 * * ? 2005"     2005年的每天早上10：15触发
"0 * 14 * * ?"         每天从下午2点开始到2点59分每分钟一次触发
"0 0/5 14 * * ?"     每天从下午2点开始到2：55分结束每5分钟一次触发
"0 0/5 14,18 * * ?"     每天的下午2点至2：55和6点至6点55分两个时间段内每5分钟一次触发
"0 0-5 14 * * ?"         每天14:00至14:05每分钟一次触发
"0 10,44 14 ? 3 WED"     三月的每周三的14：10和14：44触发
"0 15 10 ?* MON-FRI"     每个周一、周二、周三、周四、周五的10：15触发
"0 15 10 15 * ?"     每月15号的10：15触发
"0 15 10 L * ?"     每月的最后一天的10：15触发
"0 15 10 ? * 6L"     每月最后一个周五的10：15触发
"0 15 10 ? * 6L"     每月最后一个周五的10：15触发
"0 15 10 ? * 6L 2002-2005"     2002年至2005年的每月最后一个周五的10：15触发
"0 15 10 ? * 6#3"                      每月的第三个周五的10：15触发