Timer, Quartz 和 Spring 实现作业调度

一、java.util.Timer
       在Java中有一个任务处理类java.util.Timer，非常方便于处理由时间触发的事件任务，只需建立一个继承java.util.TimerTask的子类，重载父类的run()方法实现具体的任务，然后调用Timer的public void schedule(TimerTask task, long delay, long period)方法实现任务的调度。

       但是这种方法只能实现简单的任务调度，不能满足任务调度时间比较复杂的需求。比如希望系统在每周的工作日的8：00时向系统用户给出一个提示，这种方法实现起来就困难了，还有更为复杂的任务调度时间要求。

二、Quartz
       OpenSymphony 的Quartz提供了一个比较完美的任务调度解决方案。
       Quartz 是个开源的作业调度框架，为在 Java 应用程序中进行作业调度提供了简单却强大的机制。
       Quartz中有两个基本概念：作业和触发器。作业是能够调度的可执行任务，触发器提供了对作业的调度。

       1、作业
         实现 org.quartz.job 接口，实现接口方法 public void execute(JobExecutionContext context) throws JobExecutionException，在这个方法实现具体的作业任务。
      代码例子：
java 代码
      execute 方法接受一个 JobExecutionContext 对象作为参数。这个对象提供了作业实例的运行时上下文。它提供了对调度器和触发器的访问，这两者协作来启动作业以及作业的 JobDetail 对象的执行。Quartz 通过把作业的状态放在 JobDetail 对象中并让 JobDetail 构造函数启动一个作业的实例，分离了作业的执行和作业周围的状态。JobDetail 对象储存作业的侦听器、群组、数据映射、描述以及作业的其他属性。
   2、触发器
      触发器可以实现对任务执行的调度。Quartz 提供了几种不同的触发器，复杂程度各不相同。
   
      简单触发器：
    public void task() throws SchedulerException {
        // Initiate a Schedule Factory
        SchedulerFactory schedulerFactory = new StdSchedulerFactory();
        // Retrieve a scheduler from schedule factory
        Scheduler scheduler = schedulerFactory.getScheduler();
       
        // current time
        long ctime = System.currentTimeMillis();
    
        // Initiate JobDetail with job name, job group, and executable job class
        JobDetail jobDetail =
        new JobDetail("jobDetail-s1", "jobDetailGroup-s1", SimpleQuartzJob.class);
        // Initiate SimpleTrigger with its name and group name
        SimpleTrigger simpleTrigger =
        new SimpleTrigger("simpleTrigger", "triggerGroup-s1");
        // set its start up time
        simpleTrigger.setStartTime(new Date(ctime));
        // set the interval, how often the job should run (10 seconds here)
        simpleTrigger.setRepeatInterval(10000);
        // set the number of execution of this job, set to 10 times.
        // It will run 10 time and exhaust.
        simpleTrigger.setRepeatCount(100);
        // set the ending time of this job.
        // We set it for 60 seconds from its startup time here
        // Even if we set its repeat count to 10,
        // this will stop its process after 6 repeats as it gets it endtime by then.
        // simpleTrigger.setEndTime(new Date(ctime + 60000L));
        // set priority of trigger. If not set, the default is 5
        // simpleTrigger.setPriority(10);
        // schedule a job with JobDetail and Trigger
        scheduler.scheduleJob(jobDetail, simpleTrigger);
       
        // start the scheduler
        scheduler.start();
    }
      首先实例化一个 SchedulerFactory，获得调度器。创建 JobDetail 对象时，它的构造函数要接受一个 Job 作为参数。SimpleTrigger 是一个简单的触发器。在创建对象之后，设置几个基本属性以立即调度任务，然后每 10 秒重复一次，直到作业被执行 100 次。
        Cron触发器
        CronTrigger 支持比 SimpleTrigger 更具体强大的调度，实现起来却不是很复杂。CronTrigger基于 cron 表达式，支持类似日历的重复间隔更为复杂的调度时间上的要求。
      Cron 表达式包括以下 7 个字段：
秒
分
小时
月内日期
月
周内日期
年（可选字段）
      Cron 触发器利用一系列特殊字符，如下所示：
反斜线（/）字符表示增量值。例如，在秒字段中“5/15”代表从第 5 秒开始，每 15 秒一次。

问号（?）字符和字母 L 字符只有在月内日期和周内日期字段中可用。问号表示这个字段不包含具体值。所以，如果指定月内日期，可以在周内日期字段中插入“?”，表示周内日期值无关紧要。字母 L 字符是 last 的缩写。放在月内日期字段中，表示安排在当月最后一天执行。在周内日期字段中，如果“L”单独存在，就等于“7”，否则代表当月内周内日期的最后一个实例。所以“0L”表示安排在当月的最后一个星期日执行。

在月内日期字段中的字母（W）字符把执行安排在最靠近指定值的工作日。把“1W”放在月内日期字段中，表示把执行安排在当月的第一个工作日内。

井号（#）字符为给定月份指定具体的工作日实例。把“MON#2”放在周内日期字段中，表示把任务安排在当月的第二个星期一。

星号（*）字符是通配字符，表示该字段可以接受任何可能的值。
所有这些定义看起来可能有些吓人，但是只要几分钟练习之后，cron 表达式就会显得十分简单。
      下面的代码显示了 CronTrigger 的一个示例。请注意 SchedulerFactory、Scheduler 和 JobDetail 的实例化，与 SimpleTrigger 示例中的实例化是相同的。在这个示例中，只是修改了触发器。这里指定的 cron 表达式（“0/5 * * * * ?”）安排任务每 5 秒执行一次。
     public void task() throws SchedulerException {
        // Initiate a Schedule Factory
        SchedulerFactory schedulerFactory = new StdSchedulerFactory();
        // Retrieve a scheduler from schedule factory
        Scheduler scheduler = schedulerFactory.getScheduler();
       
        // current time
        long ctime = System.currentTimeMillis();
       
        // Initiate JobDetail with job name, job group, and executable job class
        JobDetail jobDetail =
        new JobDetail("jobDetail2", "jobDetailGroup2", SimpleQuartzJob.class);
        // Initiate CronTrigger with its name and group name
        CronTrigger cronTrigger = new CronTrigger("cronTrigger", "triggerGroup2");
        try {
            // setup CronExpression
            CronExpression cexp = new CronExpression("0/5 * * * * ?");
            // Assign the CronExpression to CronTrigger
            cronTrigger.setCronExpression(cexp);
        } catch (Exception e) {
            e.printStackTrace();
        }
        // schedule a job with JobDetail and Trigger
        scheduler.scheduleJob(jobDetail, cronTrigger);
       
        // start the scheduler
        scheduler.start();
    }

三、Spring + Quartz
spring对Java的Timer类和Quartz都提供了一个抽象层，使用我们可以更方便地使用它们。

1、spring与Timer的集成

    首先是一个定时器任务
public class EmailReportTask extends TimerTask {
    public EmailReportTask() {
   
    }

    public void run() {
        courseService.sendCourseEnrollmentReport();
    }

    private CourseService courseService;
    public void setCourseService(CourseService courseService) {
        this.courseService = courseService;
    }
}

        spring配置文件中配置EmailReportTask

<bean id="reportTimerTask"    
     class="com.springinaction.training.schedule.EmailReportTask">   
          <property name="courseService">          
          <ref bean="courseService"/>       
     </property>    
</bean>   



调度定时器任务

xml 代码




   
<bean id="scheduledReportTask"    
   
   
          class="org.springframework.scheduling.timer.ScheduledTimerTask">    
   
   
          <property name="timerTask">      
   
   
                <ref bean="reportTimerTask"/>    
   
   
          property>    
   
   
          <property name="period">      
   
   
                <value>86400000<value>    
   
   
          property>    
   
   
          <property name="delay">      
   
   
                <value>32000value>      
   
   
          property>    
   
   
bean>   
   



          启动定时器
xml 代码

<bean class="org.springframework.scheduling.timer.TimerFactoryBean"> 
      <property name="scheduledTimerTasks"> 
            <list>   
                  <ref bean="scheduledReportTask"/>                         
            list>   
      property> 
bean>    
2、spring与Quartz的集成

创建一个工作
public class EmailReportJob extends QuartzJobBean {  
 
    public EmailReportJob() {  
 
    }  
 
    protected void executeInternal(JobExecutionContext context)  throws JobExecutionException {  
        courseService.sendCourseEnrollmentReport();  
    }  
 
    private CourseService courseService;  
    public void setCourseService(CourseService courseService) {  
        this.courseService = courseService;  
    }  
} 
         在spring配置文件的配置EmailReportJob

<bean id="reportJob" 
      class="org.springframework.scheduling.quartz.JobDetailBean"> 
      <property name="jobClass"> 
           <value>com.springinaction.training.schedule.EmailReportJobvalue> 
      property> 
      <property name="jobDataAsMap"> 
           <map> 
                <entry key="courseService"> 
                     <ref bean="courseService"/> 
                entry> 
           map> 
      property> 
bean> 

       调度工作

       和quartz对应，Spirng提供了两个触发器SimpleTriggerBean和CronTriggerBean

       使用SimpleTriggerBean触发器

<bean id="simpleReportTrigger" 
     class="org.springframework.scheduling.quartz.SimpleTriggerBean"> 
     <property name="jobDetail"> 
          <ref bean="reportJob"/> 
     property> 
     <property name="startDelay"> 
          <value>3600000value> 
     property> 
     <property name="repeatInterval"> 
          <value>86400000value> 
     property> 
bean> 

        使用CronTriggerBean触发器

<bean id="cronReportTrigger" 
          class="org.springframework.scheduling.quartz.CronTriggerBean"> 
     <property name="jobDetail"> 
          <ref bean="reportJob"/> 
     property> 
     <property name="cronExpression"> 
          <value>0 * * * * ?value> 
     property> 
bean> 


    系统会在每分钟的0秒执行调度任务。



参考
http://www.ibm.com/developerworks/cn/java/j-quartz/
《Spring in Action》

http://www.iteye.com/topic/115666