Spring+Quartz实现定时任务 (二)

在我们进行软件项目开发的过程中，相信大家在很多时候都会遇到如下业务场景：每天、每周或每月生成相应的业务报表；每天统计系统注册人数；定期清理平台长久不登录的用户等等。遇到这种业务场景需要怎样去处理？人为定时去数据库操作来统计？别开玩笑了，这种事情哪用得着人来做，如果像这种任务还需要专人每天都去做统计，那估计很多人就要疯掉了。针对于这种业务情况，采用定时任务是个非常不错的选择。在Java领域中，定时任务的开源工具也非常多，小到一个Timer类，大到Quartz框架。总体来说，个人比较喜欢的还是Quartz，功能强大而且使用方便。接下来我们就看一下如何通过Spring和Quartz来实现业务系统中的定时任务。

Spring整合Quartz实现定时任务步骤很简单，大致需要经过如下几步：创建任务（Job）、配置JobDetail、配置触发器（Trigger）、配置SchedulerFactoryBean

好了，废话不多说了，下面进入正题。

首先创建一个web项目并引入Spring和quartz的依赖

然后在web.xml文件中引入Spring支持

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://java.sun.com/xml/ns/javaee"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
    id="WebApp_ID" version="2.5">
    <display-name>quartz_csdn</display-name>
    <welcome-file-list>
        <welcome-file>index.html</welcome-file>
        <welcome-file>index.htm</welcome-file>
        <welcome-file>index.jsp</welcome-file>
        <welcome-file>default.html</welcome-file>
        <welcome-file>default.htm</welcome-file>
        <welcome-file>default.jsp</welcome-file>
    </welcome-file-list>
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:beans.xml</param-value>
    </context-param>
</web-app>

好了，到现在为止，基本的环境算是搭建好了，接下来我们就要开始Spring+Quartz实现定时任务了。

一、创建任务（Job）

Spring+Quartz实现Job有两种方式：一种是继承 org.springframework.scheduling.quartz.QuartzJobBean类来实现Job任务，并实现里面的抽象方法 executeInternal；另一种是不继承任何类，创建普通的Java类，然后自己指定任务的执行方法（个人感觉此种方式较好，实现起来方便而且大 大降低了系统的业务的耦合性）。

我们先来看一下继承QuartzJobBean类的这种形式，创建一个任务类ExampleJob，具体代码如下：

package com.mhy.quartz;

import java.text.SimpleDateFormat;
import java.util.Date;

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

/** 
 * 继承QuartzJobBean形式的定时任务 
 */  
public class ExampleJob extends QuartzJobBean{
    private int timeout;  

    @Override
    protected void executeInternal(JobExecutionContext arg0)
            throws JobExecutionException {
         System.out.println(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date()) + "执行ExampleJob的定时任务");  
    }

    public int getTimeout() {
        return timeout;
    }

    public void setTimeout(int timeout) {
        this.timeout = timeout;
    }
    

}

为了演示方便，executeInternal方法中没有写复杂的业务逻辑，只简单的输出一句话，真正的生产环境中在该方法中实现你所需要的业务逻辑即可。

二、在Spring配置文件中配置JobDetail

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

三、配置触发器（Trigger）

Spring提供了两种触发器，如下：
1、org.springframework.scheduling.quartz.SimpleTriggerFactoryBean（此种方式是很隔多长时间进行触发一次，比如每隔24小时触发一次）
2、org.springframework.scheduling.quartz.CronTriggerFactoryBean（此种方式是在指定的 时间进行触发，比如只在周一进行触发。不过根据配置也很方便的实现类似SimpleTriggerFactoryBean形式的定时任务）
Spring所提供的这两种触发器方式和前面提到的任务创建方式均可以相互之间混用，很灵活。
这里我们先使用SimpleTriggerFactoryBean这个trigger来配置

<bean id="exampleJobTrigger"  
    class="org.springframework.scheduling.quartz.SimpleTriggerFactoryBean">  
    <property name="jobDetail" ref="exampleJobDetail" />  
    <!-- 延迟触发时间，延迟10秒进行触发 -->  
    <property name="startDelay" value="10000" />  
    <!-- 重复触发的时间间隔，5秒 -->  
    <property name="repeatInterval" value="5000" />  
</bean>

四、配置SchedulerFactoryBean

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

好了，到现在为止，一个简单的定时任务就完成了，下面我们来启动一下web项目，看运行结果如何。

很不幸的是运行失败了，这是为啥呢？别着急，慢慢看看异常信息（学会分析异常信息也是程序员重要的能力之一噢）。从异常信息中我们可以看出，JobDetailBean引用了一个接口来作为父类了。既然是这样的话，那我们就需要看一下JobDetailBean的源码了。

在Quartz中JobDetail竟然是一个接口。是不是搞错了，你肯定要问了。这是为什么呢，为什么呢，为什么呢？哈哈，这个就得谈到 Quartz的历史问题了。Quartz从1.X升级到2.X之后，JobDetail由类修改为接口了，为啥要改？那你得去问Quartz作者了，嘿 嘿。那如果再继续采用这种模式的话那肯定会错喽。那我们对它就没有法子了么？怎么可能。处理它很简单啊：一、把Quartz降到1.X版本；二、更改 Job的实现方式。

首先我们来试试使用1.X版本的Quartz

可以看到在Quartz1.X版本中，JobDetail还是一个类。接下来我们再启动一下web项目看看运行结果何如。

可以看到，在更换Quartz版本为1.X之后，定时任务正常运行了。

看到这，想必大家就要问了，其他方式呢，总不能让我们一直使用Quartz1.X版本吧？当然不是，我们还有很多办法，大家慢慢往下看。

第二部分：实现Spring3+Quartz2的定时任务。

首先创建一个基本的Java类来做为Job任务类，代码如下：

package com.mhy.quartz;

import java.text.SimpleDateFormat;
import java.util.Date;

/** 
 * 继承QuartzJobBean形式的定时任务 
 */  
public class ExampleJob2 {
    /** 
     * 执行定时统计任务 
     * 自行指定方法 
     */ 
    public void execute(){
         System.out.println(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date()) + "执行ExampleJob2");  
         
    }

}

接下来是在Spring配置文件中配置JobDetail、Trigger、SchedulerFactoryBean

<bean id="exampleJob2" class="com.mhy.quartz.ExampleJob2"></bean>  
<bean id="exampleJob2Detail"  
    class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">  
    <!-- 指定任务类 -->  
    <property name="targetObject" ref="exampleJob2" />  
    <!-- 指定任务执行的方法 -->  
    <property name="targetMethod" value="execute" />  
</bean>  
<bean id="exampleJob2Trigger"  
    class="org.springframework.scheduling.quartz.CronTriggerFactoryBean">  
    <property name="jobDetail" ref="exampleJob2Detail" />  
    <!-- 每10秒运行一次 -->  
    <property name="cronExpression" value="0/10 * * * * ?" />  
</bean>  
  
<bean class="org.springframework.scheduling.quartz.SchedulerFactoryBean">  
    <property name="triggers">  
        <list>  
            <!-- <ref bean="exampleJobTrigger" /> -->  
            <ref bean="exampleJob2Trigger" />  
        </list>  
    </property>  
</bean>

好了，配置完之后我们再启动一下程序，看看定时任务时否运行良好（这里我们使用的Trigger是CronTriggerFactoryBean，当然也可以使用SimpleTriggerFactoryBean）

关于Trigger中时间如何配置，quartz官网描述的很清楚，大家可以参考如下网址：http://quartz-scheduler.org/documentation/quartz-2.2.x/tutorials/crontrigger

OK，没有问题，好了，关于Spring+Quartz实现定时任务暂就告一段落，欢迎大家多多交流，有不当之后还请大家指正出来。

顺便贴一下cronExpression表达式备忘： 字段 允许值 允许的特殊字符

秒 0-59 , – * /

分 0-59 , – * /

小时 0-23 , – * /

日期 1-31 , – * ? / L W C

月份 1-12 或者 JAN-DEC , – * /

星期 1-7 或者 SUN-SAT , – * ? / L C #

年（可选） 留空, 1970-2099 , – * /

表达式意义

"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期间的每1分钟触发

"0 0/5 14 * * ?" 在每天下午2点到下午2:55期间的每5分钟触发

"0 0/5 14,18 * * ?" 在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发

"0 0-5 14 * * ?" 在每天下午2点到下午2:05期间的每1分钟触发

"0 10,44 14 ? 3 WED" 每年三月的星期三的下午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" 每月的第三个星期五上午10:15触发

每天早上6点

0 6 * * *

每两个小时

0 */2 * * *

晚上11点到早上8点之间每两个小时，早上八点

0 23-7/2，8 * * *

每个月的4号和每个礼拜的礼拜一到礼拜三的早上11点

0 11 4 * 1-3

1月1日早上4点

0 4 1 1 *

**本示例对应的代码需要的call我**