Spring Quartz任务调度

使用Quartz调度器

Quart使用Trigger、Job和JobDetail对象实现各种调度任务。对于Quartz背后的基本概念，参考http://quartz-scheduler.org。为了方便的目的，Spring提供一组类简化Quartz在基于Spring应用中的使用。

使用JobDetailBean

JobDetail对象包含需要运行任务的所有信息。Spring框架提供一个JobDetailBean使用更多合理默认值的真实JavaBean产生JobDetail。让我们看一下下面的例子：

<bean name="exampleJob" class="org.springframework.scheduling.quartz.JobDetailBean">    
    <property name="jobClass" value="example.ExampleJob" />
    <property name="jobDataAsMap">
        <map>
            <entry key="timeout" value="5" />
        </map>    
    </property>
</bean>

package example; 
public class ExampleJob extends QuartzJobBean {     
    private int timeout;
    /**
     * ExampleJob从JobDetailBean实例化之后Setter被调用
     */    
    public void setTimeout(int timeout) {        
        this.timeout = timeout;
    } 

    protected void executeInternal(JobExecutionContext ctx) throws JobExecutionException {
        // 做实际工作    
    }
}

所有对JobDetailBean的额外设置当然对你也是有效的。

使用name和group属性，你能分别修改任务的name和group。默认情况下，任务的name匹配JobDetailBean的name（在上
面的例子中，是exampleJob）。

使用MethodInvokinJobDetailFactoryBean

通常你需要在指定对象上调用一个方法。使用MethodInvokingJobDetailFactoryBean你可以做到这一点：

<bean id="jobDetail" 
    class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">
    <property name="targetObject" ref="exampleBusinessObject" />    
    <property name="targetMethod" value="doIt" />
</bean>

上面的例子将导致exampleBusinessObject的doIt方法被调用：

public class ExampleBusinessObject {    
    // 属性和引用    
    public void doIt() {        
        // 真实业务
    }
}

<bean id="exampleBusinessObject" class="examples.ExampleBusinessObject"/>

使用MethodInvokingJobDetailFactoryBean，你不需要创建一行任务立即调用一个方法，你只需要创建一个实际业务对象并装配给detail对象。

默认情况下，Quartz任务是无状态的，导致任务相互干扰的可能性。如果你使用相同的JobDetail指定两个触发器，他可能在第一个任务之前完成，第二个任务才开始。如果JobDetail累实现Stateful接口，这将不会发生。第二个任务将不会再第一个任务完成之前开始。为了使来源于MethodInvokingJobDetailFactoryBean的任务是非并发的，设置concurrent标记为false。

<bean id="jobDetail" 
    class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">    
    <property name="targetObject" ref="exampleBusinessObject" />    
    <property name="targetMethod" value="doIt" />    
    <property name="concurrent" value="false" />
</bean>

默认情况下，任务将以并发形式运行。

使用触发器和SchedulerFactoryBean装配任务

我们将创建任务detail和任务。我们也回顾一下允许你在指定对象上调用一个方法的便利bean。当然，我们将需要任务自身的时间表。使用触发器和SchedulerFactoryBean来完成。Quartz中有多个触发器是有效的，Spring提供两个Quartz FactoryBean默认便利实现：CronTriggerFactoryBean和SimpleTriggerFactoryBean。

触发器需要被调度。Spring提供一个SchedulerFactoryBean暴露触发器作为属性设置。SchedulerFactoryBean使用这些触发器调度实际任务。

看看下面的例子：

<bean id="simpleTrigger" class="org.springframework.scheduling.quartz.SimpleTriggerFactoryBean">    
    <!--调用上面例子中的方法 -->    
    <property name="jobDetail" ref="jobDetail" />    
    <!-- 10秒 -->    
    <property name="startDelay" value="10000" />    
    <!--没50秒重复一次 -->    
    <property name="repeatInterval" value="50000" />
</bean>
 
<bean id="cronTrigger" class="org.springframework.scheduling.quartz.CronTriggerFactoryBean">    
    <property name="jobDetail" ref="exampleJob" />    
    <!--每天早上六点钟运行 -->    
    <property name="cronExpression" value="0 0 6 * * ?" />
</bean>

现在，我们设置两个触发器，一个10秒的启动延时每50秒运行一次，另一个每天早上6点运行一次。最后完成一件事，我们需要设置SchedulerFactoryBean：

<bean class="org.springframework.scheduling.quartz.SchedulerFactoryBean">    
    <property name="triggers">        
        <list>            
            <ref bean="cronTrigger" />            
            <ref bean="simpleTrigger" />        
        </list>    
    </property>
</bean>

你能为SchedulerFactoryBean设置更多有效的属性，例如使用日历的任务detail，使用属性来定制Quartz，等等。更多细节参考SchedulerFactoryBean的JavaDoc。