Java Web应用中的任务调度

刚刚看到,也是我心中一直存在的一个问题,把他收集起来以便日后研究,
任务调度是大型J2EE web应用中常见的工作。开发者希望以指定的间隔时间执行各类操作，并完成一些无需用户输入的任务。Java中
可有无数方法来做到这一点，但是在web应用中却并没有这方面的统一标准。当许多开发人员参与同一个项目，并且以各自不同的方
式来实现任务调度时，就可能产生很大问题。内存和同步问题就是必须首先考虑的两件事。事实上，一些开发者试图调用操作系统层
面的任务调度机制，如Unix平台上的cron。这种编程实践也许并不是太坏，但它将直接导致可移植性被抛到九霄云外
 版权声明：任何获得Matrix授权的网站，转载时请务必保留以下作者信息和链接
作者:Chris Hardin;Caesar(作者的blog:http://blog.matrix.org.cn/page/Caesar)
原文:http://www.matrix.org.cn/resource/article/44/44357_Quartz+Java.html
关键字:Quartz;scheduling
为何需要任务调度？
在web应用中，大多数任务是以一种"防止用户长时间等待"的方式完成的。在Google搜索这样的例子中，减少等待时间对用户体验来
说至关重要。异步任务的一种解决方案是在用户提交后生成一个线程（来处理异步任务），但这也不能解决那些需要以一定时间间隔
重复运行任务、或在每天的指定时间运行任务的情况。

让我们从一个数据库报表的例子来看看任务调度能如何帮助改善系统设计。报表可能是错综复杂的，这取决于用户所需数据的种类，
以及是否需要从一个或多个数据库收集大量数据。用户可能需要很长时间来运行这样的"按需"报表。因此，我们向这个报表示例中添
加任务调度机制，以便用户可以安排在任何他们需要的时间生成报表，并以PDF或其他格式在email中发送。用户可以让报表在每天的
凌晨2:22，系统正处于低负荷时运行；也可以选择只在特定时间运行一次。通过在报表应用中加入任务调度，我们可以为产品添加一
项有用的功能，并改善用户体验。

幸运的是，有一个强大的开源解决方案可以让我们以标准的方式在web应用（或任何Java应用）中实施任务调度。以下示例展示了在
web应用中，如何使用Quartz来创建一个任务调度框架。这个示例还使用了Struts Action framework 插件，以便在web应用启动时初始化
任务调度机制。Struts是最常见的MVC框架，为大多数开发人员所熟悉。当然除此之外还有许多框架可以协助在web应用中实现MVC模
式。

启动时初始化任务调度器

我们首先要做的是建立一个Struts插件，让它在容器启动时创建我们的任务调度器。在以下例子中，我们选择Tomcat作为web应用容
器，不过这些示例在其他容器中也应当可以运行。我们要创建一个Struts插件类，并在struts-config.xml中加入几行代码以使之可以工
作。

这个插件有两个可配置的初始化参数：startOnLoad指定是否要在容器启动时立即启动任务调度器，而 startupDelay指定启动任务调度
器之前的等待时间。启动延时很有用，因为我们可能需要首先执行一些更重要的初始化步骤。此外还可以使用listener机制，以更复杂
的方式来通知SchedulerPlugIn何时启动Quartz Scheduler。

我们要创建的是一个实现Struts插件接口org.apache.struts.action.PlugIn的单子类SchedulerPlugIn。Struts会按照配置文件中出现的顺序
初始化各个插件。要特别注意的是init()方法中的代码，在此我们初始化了所需的Quartz对象，并得到Scheduler。我们的任务信息就要
提交到此org.quartz.Scheduler对象，后者将在随后讨论。Scheduler对象由Quartz servlet根据其配置初始化，就像Struts初始化它的ActionServlet类一样。让我们来看init()方法：

public void init(ActionServlet　actionServlet,ModuleConfig moduleConfig) {  
    System.out.println("Initializing Scheduler PlugIn for Jobs!");  
    // Retrieve the ServletContext
    // 获取ServletContext  
    ServletContext ctx = actionServlet.getServletContext(); 
     // The Quartz Scheduler 
     // Quartz Scheduler对象  
    Scheduler scheduler = null; 
     // Retrieve the factory from the ServletContext.  
    // It will be put there by the Quartz Servlet  
    // 从ServletContext取得由Quartz Servlet放置在此的factory对象。  
    StdSchedulerFactory factory =  (StdSchedulerFactory)       ctx.getAttribute(QuartzInitializerServlet.QUARTZ_FACTORY_KEY);      
    try{        
            // Retrieve the scheduler from the factory        
            // 从factory取得scheduler       
             scheduler = factory.getScheduler();        
            // Start the scheduler in case, it isn't started yet        
            // 如果scheduler尚未启动，则启动它        
            if (m_startOnLoad != null &&             m_startOnLoad.equals(Boolean.TRUE.toString()))
            {
                System.out.println("Scheduler Will start in "             m_startupDelayString  " milliseconds!"); 
               //wait the specified amount of time before 
               // starting the process. 
               // 在启动之前等待指定长度的时间
                Thread delayedScheduler =                new Thread(new DelayedSchedulerStarted (                                   scheduler, m_startupDelay)); 
               //give the scheduler a name. All good code needs a name 
               //给任务调度器命名。好的代码总该有名字！
                delayedScheduler.setName("Delayed_Scheduler");
                //Start out scheduler 
               //启动任务调度器
                delayedScheduler.start(); 
           }  
    } catch (Exception e){ 
        e.printStackTrace(); 
     } 
       sm_scheduler = scheduler;
}

配置过程的第二步是在web.xml中加入用来初始化Quartz servlet（org.quartz.ee.servlet.QuartzInitializerServlet）的内容，因为需要它将
SchedulerFactory添加到ServletContext中，以便在我们的Struts插件中可以访问。SchedulerFactory就是我们在Struts插件中获得Scheduler
对象的来源。除了struts-config.xml 和web.xml之外，还要在web应用的classes目录下放置一个quartz.properties文件。此文件的位置也可
以在web.xml中作为QuartzInitializerServlet的启动参数来指定。

QuartzInitializer     
Quartz Initializer Servlet      org.quartz.ee.servlet.QuartzInitializerServlet    
1      
shutdown-on-unload    
true        
start-scheduler-on-load    
false

这里其实完全可以不使用Struts和SchedulerPlugIn，但如果将来决定要以其它的任务调度框架替换Quartz的话，额外的抽象层就很有用
了。长远看来，让一切保持松散耦合总会使工作变得容易些。如果你使用其它MVC框架，也可以用SchedulerPlugIn.init()方法中的代码
达到同样的效果。此外，还可以用Servlet 2.3规范中的ServletContextListener来实现同样的初始化过程。

到此为止web应用已配置完毕，我们可以创建一个.war文件并部署到服务器上，从控制台观察SchedulerPlugIn的输出信息。然而在此之
前，让我们先看看如何向任务调度器提交一项任务。

我们可以从web应用中的任何类访问SchedulerPlugIn的唯一实例，并调度一些要执行的工作。首先需要一个Trigger（触发器）对象来告
诉任务何时运行、每隔多久运行一次。Quartz支持多种触发器，在这个例子中我们使用CronTrigger。

Trigger trigger = new CronTrigger("trigger1", "group1");trigger.setCronExpression("0 0 15 ? * WED");

以上的触发器会在每周三的下午3点执行指定任务。现在我们只要创建一个JobDetail对象，并把它和上面的触发器一起传递给SchedulerPlugIn的scheduleWork()方法。

JobDetail jobDetail =  new JobDetail("Hello World Job", "Hello World　Group",HelloWorld.class,true, true, true);    
//Schedule The work
//调度这项任务    
SchedulerPlugIn.scheduleWork(scheduledJobDetail, trigger);

实际工作在何处？

至此我们已决定Trigger，可以开始调度工作了。看上去一切都已完成，但实际上我们只是调度了一项任务，还有最重要的
一步有待完成。注意HelloWorld.class作为参数传递给了JobDetail的构造函数。这个类就是实际完成工作的地方。
HelloWorld继承了Quartz的Job类，并覆盖了execute()方法。当任务管理器决定运行这个任务时，execute()方法将被
调用。来看代码

import org.quartz.JobDataMap;import org.quartz.JobDetail;import org.quartz.JobExecutionContext;
//extend the proper Quartz class
//继承适当的Quartz类
public class HelloWorld extends Job {
//override the execute method
//覆盖execute方法    
public void execute(JobExecutionContext context) {
// Every job has it's own job detail
//每个Job都有独立的JobDetail    
JobDetail jobDetail = context.getJobDetail();
// The name is defined in the job definition
//name在Job定义中指定    
String jobName = jobDetail.getName();
//Every job has a Job Data map for storing extra information
//每个Job都有一个Job Data map来存放额外的信息    JobDataMap dataMap = jobDetail.getJobDataMap();              
System.out.println("Hello World!!!");   
} 
}

出于测试的目的，你可能希望将触发器的频率调的高一点，以便观察到HelloWorld的动作。毕竟，你不想一直等到凌晨2点
才能确定调度的任务确实运行了。相反，你可能需要一个每隔10秒运行的触发器：

Trigger trigger = new SimpleTrigger("trigger1", "group1");
trigger.setRepeatCount(SimpleTrigger.REPEAT_INDEFINITELY);
trigger.setRepeatInterval(10000L); 
// milliseconds毫秒

注意，这个触发器没有使用类cron的语法。Quartz有大量各类的选项和配置方法，可适用于任何任务调度的需要。
        
其它计时方式的配置

Quartz提供了多种调度任务的方式。CronTrigger可能是最复杂的一种，不过还有其它的选择。大多数触发器可以由Quartz提供的TriggerUtils类创建。以下是一些常见的触发器的例子。如谚语所言，条条大路通罗马！
每天凌晨2:22触发的触发器
// 方法一：使用makeDailyTrigger

Trigger trigger = TriggerUtils.makeDailyTrigger(2, 22);
trigger.setName("trigger1");
trigger.setGroup("group1");

// 方法二：使用CronTrigger

Trigger trigger = new CronTrigger("trigger1", "group1");
trigger.setCronExpression("0 22 2   ?");


每5秒执行一次的触发器

方法一：makeSecondlyTrigger  
注意以下代码将创建一个立即启动的触发器。
要控制启动时间，使用  trigger.setStartTime(Date)方法。 **/
Trigger trigger = TriggerUtils.makeSecondlyTrigger(5);
trigger.setName("MyFiveSecondTrigger");
trigger.setGroup("MyTriggerGroup");

 /*     
方法二：设置SimpleTrigger的重复次数和间隔时间。  
注意以下代码将创建一个立即启动的触发器。要控制启动时间，使用  trigger.setStartTime(Date)方法。 */
Trigger trigger = new SimpleTrigger("trigger1", "group1");
trigger.setRepeatCount(SimpleTrigger.REPEAT_INDEFINITELY);
trigger.setRepeatInterval(5000L); 
// milliseconds

按间隔时间运行任务

Trigger trigger = new SimpleTrigger("trigger1", "group1");
// 24 hours  60(minutes per hour) 
// 60(seconds per minute)  
1000(milliseconds per second)
// 24小时  60（分钟每小时）  60（秒每分钟） 1000（毫秒每秒钟）
trigger.setRepeatInterval(24L  60L  60L * 1000L);

结论
在这个演示中，我们只接触了Quartz框架的一些初级功能。记住，Java 5 和J2EE 5也有自己的任务调度机制，但是它们不像Quartz那样
灵活易用。Quartz是目前唯一的开源Java任务调度框架，它的确为开发者的锦囊中增加了很有用的内容。你可从Open Symphony下载
Quartz，并得到一份很好的教程和使用说明。