定时执行任务之quartz

关于定时执行某个或者某些任务的需求是常有发生，要解决此问题总共有两种方法，一种是通过开源的quartz框架完成，此框架由Java语言编写；另一种就是Java自带的定时器Timer。在本篇文章中我们将介绍quartz框架的使用方法。

要开始使用 Quartz，需要用 Quartz API 对项目进行配置。步骤如下：

1. 下载 Quartz API。
2. 解压缩并把 quartz-x.x.x.jar 放在项目文件夹内，或者把文件放在项目的类路径中。
3. 把 core 和/或 optional 文件夹中的 jar 文件放在项目的文件夹或项目的类路径中。
4. 如果使用 JDBCJobStore，把所有的 JDBC jar 文件放在项目的文件夹或项目的类路径中。 

接下来就是大显身手的时候了，首先，我们编写一个实现接口 org.quartz.job的类，此接口中只有一个方法execute，如：

public class SaleAdminQuartzJob implements Job  {
    /**
     * 执行任务
     */
    public void execute(JobExecutionContext arg0) throws JobExecutionException {
        System.out.println("谢谢使用");
    }
}

然后，我们要编写一个调度器，通过那个调度器来执行此任务。关于调度器，quartz总共分为两种——CronTrigger和SimpleTrigger。顾名思义，前者比后者要复杂，其实也不是说复杂，而是具体，前者可以按照你指定的秒、分、时、周、月、年等参数来执行任务，而后者主要是以1/1000为单位的简单时间，可是设置startTime、endTime、repeatCount、repeatInterval等主要参数。在此，后者就不举例了，直接讲解前者的使用方法吧，我们先来看看我编写的源代码：

public class SaleAminScheduler {
    /**
     * 调度任务
     * @throws SchedulerException void
     * @author 周玲斌
     * @date   2012-3-28
     */
    public void task() throws SchedulerException
    {
        // 实例化一个调度器工厂
        SchedulerFactory schedulerFactory = new StdSchedulerFactory();
        // 创建 一个 调度器
        Scheduler scheduler = schedulerFactory.getScheduler();
        //此三个参数是必传的
        JobDetail jobDetail = new JobDetail("jobDetailName", "jobDetailGroup", SaleAdminQuartzJob.class);
        CronTrigger cronTrigger = new CronTrigger("cronTrigger", "cronTriggerGroup");
        try {
            // 参数共七个：秒、分、时、月内日期、月、周内日期、年(可选)
            CronExpression cexp = new CronExpression("0 0 0 * * ?");
            cronTrigger.setCronExpression(cexp);
        } catch (Exception e) {
            e.printStackTrace();
        }
        scheduler.scheduleJob(jobDetail, cronTrigger);
        scheduler.start();
    }
    
    public static void main (String args[]) 
    {
        try {
            SaleAminScheduler qRunner = new SaleAminScheduler();
            qRunner.task();
        } catch (Exception e)
        {
            e.printStackTrace();
        }
    }
    
}


现在我们来通过代码讲解其中的类与方法吧：

1、JobDetail

JobDetail是用来包装Job实例的具体细节的。Job以class的方式传入JobDetail，quartz会自动实例化Job类的。同时需要规定job的name和group，在jobdetail的validate()下，一个job是必须有name和group属性，并且二者组合标示唯一的job。JobDetail中的一些重要数据存放在JobDataMap中，这个map可以用来在控制程序和job内传递需要传递的参数。
JobDetail还有三个重要的boolean值的属性，分别是durability、volatility、shouldRecover。这三个属性默认是false，主要在数据库操作的时候起作用。


2、CronExpression


用来设置调度的时间，就如注释上说的那样，总共有七个参数，最后一个是可选的，因此，当不涉及到年的时候你可以只写留个参数，这样讲应该很清楚了吧。可能比较头疼的是不知道里面的特殊字符是啥意思，呵呵，接下来我们就来讲讲此定时器里面的特殊字符：

Cron 触发器利用一系列特殊字符，如下所示：

• 反斜线（/）字符表示增量值。例如，在秒字段中“5/15”代表从第 5 秒开始，每 15 秒一次。


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


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


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


• 星号（*）字符是通配字符，表示该字段可以接受任何可能的值。

如：

1、代码中的时间表示每天的零点进行任务调度；

2、0 15 10 ？ * MON-FRI：将在星期一到星期五的每天上午10点15分执行一个作业。

3、0 15 10 ？ * 6L 2002-2005：将在2002年到2005年的每个月的最后一个星期五上午10点15分执行作业。




接下来，我们来讲讲此框架中的一些基本概念：

1、Job：是quartz中最基本的概念了，Job做为一个接口只有一个execute()方法等待实现，理论上所有用quartz执行的job都需要实现这个接口，但是现在大多数的系统都不会服从这种约束，而希望能够更自由的调用原有系统中的类的方法。实现自由调用，有两个途径，我上一节总结中的那个方案是一个简单的途径，另外一个途径就是借助于spring的class bean，这个将在后面介绍。
2、StatefullJob接口: 无状态任务对应的JobDataMap可以认为是只读的,而有状态的任务在多次执行过程中保留对JobDataMap所作的修改,一个后果是有状态任务无法被并发执行。


3、Calendar：这个类用来标识出特殊的时间，scheduler根据trigger执行job的时候，如果遇到这些标识出的特殊时间则不执行job。Calendar具体的接口有BaseCalendar、AnnualCalendar、HolidayCalendar、MonthlyCalendar、WeeklyCalendar等等。calendar的具体用法参看quartz的文档。
Misfire Instruction....设定当trigger错过了触发时刻的时候需要采取的处理策略
4、TriggerUtils：相当于一个trigger factory，方便我们取得特殊trigger的实例，而不用自己去构造。
5、Listener：是用来监听quartz的执行过程的，主要有JobListener，TriggerListener，SchedulerListener。joblistener监听一个job在quartz中执行的待执行，禁止执行，执行完毕三个状态。TriggerListener监听trigger触发、完成、错过、禁止四个状态。SchedulerListener监听scheduler执行过程的一些状态，具体参看SchedulerListener的源代码。


quartz框架的有状态和无状态作业

在本文中你所看到的作业到是无状态的。这意味着在两次作业执行之间，不会去维护作业执行时JobDataMap的状态改变。如果你需要能增、删，改JobDataMap的值，而且能让作业在下次执行时能看到这个状态改变，则需要用Quartz有状态作业。

如果你是一个有经验的EJB开发者的话，深信你会立即退缩，因为有状态带有负面含义。这主要是由于EJB带来的伸缩性问题。Quartz有状态作业实现了org.quartz.StatefulJob接口。

无状态和有状态作业的关键不同是有状态作业在每次执行时只有一个实例。大多数情况下，有状态的作业不回带来大的问题。然而，如果你有一个需要频繁执行的作业或者需要很长时间才能完成的作业，那么有状态作业可能给你带来伸缩性问题。




quartz的监听器和插件

每个人都喜欢监听和插件。今天，几乎下载任何开源框架，你必定会发现支持这两个概念。监听是你创建的Java类，当关键事件发生时会收到框架的回调。例如，当一个作业被调度、没有调度或触发器终止和不再打火时，这些都可以通过设置来来通知你的监听器。Quartz框架包含了调度器监听、作业和触发器监听。你可以配置作业和触发器监听为全局监听或者是特定于作业和触发器的监听。

一旦你的一个具体监听被调用，你就能使用这个技术来做一些你想要在监听类里面做的事情。例如，你如果想要在每次作业完成时发送一个电子邮件，你可以将这个逻辑写进作业里面，也可以JobListener里面。写进JobListener的方式强制使用松耦合有利于设计上做到更好。

Quartz插件是一个新的功能特性，无须修改Quartz源码便可被创建和添加进Quartz框架。他为想要扩展Quartz框架又没有时间提交改变给Quartz开发团队和等待新版本的开发人员而设计。如果你熟悉Struts插件的话，那么完全可以理解Quartz插件的使用。

与其Quartz提供一个不能满足你需要的有限扩展点，还不如通过使用插件来拥有可修整的扩展点。

参考资料：http://tech.ccidnet.com/art/1112/20051122/377733_1.html

http://www.ibm.com/developerworks/cn/java/j-quartz/index.html#download