Spring--Quartz 任务调度的配置详解

Quartz调度器为调度工作提供了更丰富的支持。和Java定时器一样，可以使用Quartz来每隔多少毫秒执行一个工作。但Quartz比Java Timer更先进之处在于它允许你调度一个工作在某个特定的时间或日期执行。

关于Quartz的更多信息，可以访问Quartz位于http://www.opensymphony.com/quartz的主页。

项目中需要的jar包：

spring-framework-2.5.6\dist\spring.jar
spring-framework-2.5.6\lib\quartz\quartz-all-1.6.1.jar
spring-framework-2.5.6\lib\jakarta-commons\commons-logging.jar
spring-framework-2.5.6\lib\jakarta-commons\commons-collections.jar
spring-framework-2.5.6\lib\log4j\log4j-1.2.15.jar

下面为Quartz配置操作详述：

A:extends QuartzJobBean方法

1：定义任务（extends QuartzJobBean）


package com.sample.quartz;

import org.quartz.JobExecutionContext;
import org.springframework.scheduling.quartz.QuartzJobBean;

public class QuartzExtends extends QuartzJobBean {
  private JobData jobData; //JobData为自定义类
     public void executeInternal(JobExecutionContext context){
        System.out.println(jobData.getData()+" is executed");
     }
     public JobData getJobData() {
        return jobData;
     }
     public void setJobData(JobData jobData) {
        this.jobData = jobData;
     }
}

JobData.java:

package onlyfun.bb.Quartz;
import java.util.Date;
public class JobData {
    public String getData(){
       return "Data from JobData at "+new Date().toString();
    }
}


2: 配置


  <!-- 继承quartzjobbean的配置 -->
   <bean id="someData" class="com.sample.quartz.JobData"></bean>
   <bean id="jobDetailBean" class="org.springframework.scheduling.quartz.JobDetailBean">
       <property name="jobClass" value="com.sample.quartz.QuartzExtends"></property>
       <property name="jobDataAsMap">
         <map>
           <entry key="jobData" value-ref="someData"></entry>
         </map>
       </property>
   </bean>

   <bean id="simpleTriggerBean" class="org.springframework.scheduling.quartz.SimpleTriggerBean">
       <property name="jobDetail" ref="jobDetailBean"></property>
       <property name="repeatInterval" value="2000"></property>
       <property name="startDelay" value="1000"></property>
   </bean>

<!-- quartz触发器管理 -->
<bean id="sdf"
  class="org.springframework.scheduling.quartz.SchedulerFactoryBean">
  <!-- 添加触发器 -->
  <property name="triggers">
   <list>
       <ref bean="simpleTriggerBean" />
    <!--这里调用的列表，还可以添加其他的任务 -->
   </list>
  </property>
</bean>


注意：在JobDetailBean的jobClass属性必须提供Job的类名称，而不是Job类的实例。Job所需的数据可以在jobDataAsMap属性中设置。

在任务的周期指定上，使用SimpleTriggerBean类来指定，与TimerTask指定方式类似。

排定Job用SchedulerFactoryBean类。

完成设置后，只要在启动Spring并读取定义文件后，计划任务就会执行。


B：不需要继承的任务制定方法
使用Spring不一定需要继承QuartzJobBean类来定义1个Job类，可以使用MethodInvokingJobDetailFactoryBean来直接指定执行某个对象的方法。


1。建立调度类

package com.sample.quartz;

import java.text.SimpleDateFormat;
import java.util.Date;
public class QuartzSimple{
  /*
   * 该方法为任务调度是自动调用的方法，在这里可以实现你要实现的功能
   */
   public void test() {
    SimpleDateFormat sdf=new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
    System.out.println(sdf.format(new Date()) + "时刻的调用");
   }
}

2。对applicationContext.xml进行配置，配置文件如下：

<!--定时执行配置 -->
   <bean id="testQuartz" class="com.sample.quartz.QuartzSimple" />
   <!-- bean触发方法配置 -->
   <bean name="quartzBean"
    class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">
    <!-- bean名字 -->
    <property name="targetObject" ref="testQuartz" /><!--目标对象-->
    <!-- bean方法 -->
    <property name="targetMethod"><!--目标方法-->
     <value>test</value>
    </property>
    <property name="concurrent"><!--配置为false不允许任务并发执行-->
     <value>false</value>
    </property>
   </bean>  
 
     <!-- bean触发时间配置,指定具体的时间执行 -->  
     <bean id="quartzTrigger" class="org.springframework.scheduling.quartz.CronTriggerBean">  
          <!-- 触发bean配置 -->  
         <property name="jobDetail" ref="quartzBean" />  
          <!-- 触发时间配置 -->  
          <property name="cronExpression">  
             <value>0/10 * * * * ?</value>  
          </property>
      </bean>

C.web程序测试

在web.xml中对Spring进行配置，配置文件代码如下：

<!-- spring -->  
   <context-param>  
        <param-name>contextConfigLocation</param-name>  
        <param-value>classpath:applicationContext.xml</param-value>  
    </context-param>  
    <listener>  
       <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>  
    </listener>


D.CronTrigger配置格式:格式: [秒] [分] [小时] [日] [月] [周] [年]序号 说明  是否必填 允许填写的值 允许的通配符
1 秒 是 0-59  , - * /
2 分 是 0-59  , - * /
3 小时 是 0-23 , - * /
4 日 是 1-31 , - * ? / L W
5 月 是 1-12 or JAN-DEC , - * /
6 周 是 1-7 or SUN-SAT , - * ? / L # 
7 年 否 empty 或 1970-2099 , - * / 

通配符说明:
* ：表示所有值. 例如:在分的字段上设置 "*",表示每一分钟都会触发。
? ：表示不指定值。使用的场景为不需要关心当前设置这个字段的值。例如:要在每月的10号触发一个操作，但不关心是周几，所以需要周位置的那个字段设置为"?" 具体设置为 0 0 0 10 *
?- ：表示区间。例如 在小时上设置 "10-12",表示 10,11,12点都会触发。
, ：表示指定多个值，例如在周字段上设置 "MON,WED,FRI" 表示周一，周三和周五触发
/ ：用于递增触发。如在秒上面设置"5/15" 表示从5秒开始，每增15秒触发(5,20,35,50)。 在月字段上设置'1/3'所示每月1号开始，每隔三天触发一次。
L ：表示最后的意思。在日字段设置上，表示当月的最后一天(依据当前月份，如果是二月还会依据是否是润年[leap]), 在周字段上表示星期六，相当于"7"或"SAT"。如果在"L"前加上数字，则表示该数据的最后一个。例如在周字段上设置"6L"这样的格式,则表示“本月最后一个星期五" W ：表示离指定日期的最近那个工作日(周一至周五). 例如在日字段上设置"15W"，表示离每月15号最近的那个工作日触发。如果15号正好是周六，则找最近的周五(14号)触发, 如果15号是周未，则找最近的下周一(16号)触发.如果15号正好在工作日(周一至周五)，则就在该天触发。如果指定格式为 "1W",它则表示每月1号往后最近的工作日触发。如果1号正是周六，则将在3号下周一触发。(注，"W"前只能设置具体的数字,不允许区间"-").'L'和 'W'可以一组合使用。如果在日字段上设置"LW",则表示在本月的最后一个工作日触发 
# ：序号(表示每月的第几周星期几)，例如在周字段上设置"6#3"表示在每月的第三个周星期六.注意如果指定"6#5",正好第五周没有星期六，则不会触发该配置(用在母亲节和父亲节再合适不过了) 周字段的设置，若使用英文字母是不区分大小写的 MON 与mon相同.常用示例: 格式: [秒] [分] [小时] [日] [月] [周] [年]
0 0 12 * * ?           每天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点59分(整点开始，每隔5分触发) 
0 0/5 14,18 * * ?        每天下午的 18点到18点59分(整点开始，每隔5分触发)
0 0-5 14 * * ?            每天下午的 2点到2点05分每分触发
0 10,44 14 ? 3 WED        3月分每周三下午的 2点10分和2点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 2002-2005  从2002年到2005年每月最后一周的星期五的10点15分触发
0 15 10 ? * 6#3           每月的第三周的星期五开始触发
0 0 12 1/5 * ?            每月的第一个中午开始每隔5天触发一次
0 11 11 11 11 ?           每年的11月11号 11点11分触发(光棍节)注意：使用SimpleTriggerBean类只能做简单Job与Job之间的执行周期指定，如果需要在指定时间执行，可以使用CronTriggerBean类。

SimpleTriggerBean:

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

CronTriggerBean:

<property name="cronExpression" value="0 37-38 15 * * ?"/>

注意：CronTriggerBean的cronExpression属性指定格式：至少6个时间元素，上面表示每天的15：37-38分执行1次任务。