【SSH项目实战】国税协同平台-34.quartz&CronTrigger

我们上次使用quartz任务调度框架创建了一个在后台按照时间间隔不停运行的任务，我们使用的是simpleTrigger简单触发器，为了实现我们的月末自动回复的功能，我们要设置触发器能够在某个精确时间去自动执行任务，那么使用simpleTrigger简单触发器就远远不够了，我们需要使用CronTrigger任务触发器来实现这个功能。

我们的CronTrigger设置步骤如下:
任务触发器（CronTrigger）
① 设置任务详细
② 设置执行时机（cronExpression）
cronExpression:秒 分 时 日 月 周 年（可选）

我们先在任务类中写另外一个执行方法:

[java]  view plain copy

1. package cn.edu.hpu.tax.complain;  
2.   
3. import java.text.SimpleDateFormat;  
4. import java.util.Date;  
5.   
6. public class QuartzTask {  
7.       
8.     public void doSimpleTriggerTask() {  
9.         SimpleDateFormat sdf=new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");  
10.         System.out.println("doing simpleTrigger task..."+sdf.format(new Date()));  
11.     }  
12.       
13.     public void doCronTriggerTask() {  
14.         SimpleDateFormat sdf=new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");  
15.         System.out.println("doing cronTrigger task..."+sdf.format(new Date()));  
16.     }  
17. }  

就是上面的doCronTriggerTask()

然后修改我们的quartz的配置文件quartz-spring.xml如下:

[html]  view plain copy

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <beans xmlns="http://www.springframework.org/schema/beans"  
3.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p"  
4.     xmlns:context="http://www.springframework.org/schema/context"  
5.     xmlns:aop="http://www.springframework.org/schema/aop" xmlns:tx="http://www.springframework.org/schema/tx"  
6.     xsi:schemaLocation=" http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd   
7.     http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.0.xsd   
8.     http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.0.xsd  
9.     http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd">  
10.       
11.     <!-- 注册一个普通bean -->  
12.     <bean id="quartzTask" class="cn.edu.hpu.tax.complain.QuartzTask"></bean>  
13.       
14.     <!-- 1.指定任务详细信息 -->  
15.     <bean id="jobDetial1" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">  
16.         <!--  ① 设置执行对象 -->  
17.         <property name="targetObject" ref="quartzTask"></property>  
18.         <!--  ② 设置执行对象中对应的执行方法 -->  
19.         <property name="targetMethod" value="doSimpleTriggerTask"></property>  
20.         <!--  ③ 是否可以同步执行(这里设置不同步执行) -->  
21.         <property name="concurrent" value="false"></property>  
22.     </bean>  
23.     
24.     <bean id="jobDetial2" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">  
25.         <!--  ① 设置执行对象 -->  
26.         <property name="targetObject" ref="quartzTask"></property>  
27.         <!--  ② 设置执行对象中对应的执行方法 -->  
28.         <property name="targetMethod" value="doCronTriggerTask"></property>  
29.         <!--  ③ 是否可以同步执行(这里设置不同步执行) -->  
30.         <property name="concurrent" value="false"></property>  
31.     </bean>  
32.       
33.     <!-- 2.制定任务执行时机(任务执行触发器) -->  
34.     <bean id="simpleTrigger" class="org.springframework.scheduling.quartz.SimpleTriggerBean">  
35.         <!-- ① 设置任务详细 -->  
36.         <property name="jobDetail" ref="jobDetial1"></property>  
37.         <!-- ② 设置任务延迟执行时间(延迟2秒) -->  
38.         <property name="startDelay" value="2000"></property>  
39.         <!-- ③ 设置任务执行频率(执行频率为每2秒执行一下) -->  
40.         <property name="repeatInterval" value="2000"></property>  
41.     </bean>  
42.       
43.     <bean id="cronTrigger" class="org.springframework.scheduling.quartz.CronTriggerBean">  
44.         <!-- 设置任务详细 -->  
45.         <property name="jobDetail" ref="jobDetial2"></property>  
46.         <!-- 设置任务执行时机，cron表达式 -->  
47.         <property name="cronExpression" value="0/3 * * * * ?"></property>  
48.     </bean>  
49.       
50.     <!-- 3.设置调度工厂 -->  
51.     <bean class="org.springframework.scheduling.quartz.SchedulerFactoryBean">  
52.         <property name="triggers">  
53.             <list>  
54.                 <!-- 第一个触发器 -->  
55.                 <ref bean="simpleTrigger"/>  
56.                 <!-- 第二个触发器 -->  
57.                 <ref bean="cronTrigger"/>  
58.             </list>  
59.         </property>  
60.     </bean>  
61. </beans>  

CronTrigger中的 cronExpression 表达式属性中接收的内容：
在表达式中时间格式间用空格隔开，每个时间表示：秒 分钟 小时 日 月 周 年(可选填)
可出现的值和符合：


'*' 字符可以用于所有字段，在“分”字段中设为"*"表示"每一分钟"的含义。

'?' 字符可以用在“日”和“周几”字段. 它用来指定 '不明确的值'. 这在你需要指定这两个字段中的某一个值而不是另外一个的时候会被用到。在后面的例子中可以看到其含义。

'-' 字符被用来指定一个值的范围，比如在“小时”字段中设为"10-12"表示"10点到12点".

',' 字符指定数个值。比如在“周几”字段中设为"MON,WED,FRI"表示"the days Monday, Wednesday, and Friday".

'/' 字符用来指定一个值的的增加幅度. 比如在“秒”字段中设置为"0/15"表示"第0, 15, 30, 和 45秒"。而 "5/15"则表示"第5, 20, 35, 和 50". 在'/'前加"*"字符相当于指定从0秒开始. 每个字段都有一系列可以开始或结束的数值。对于“秒”和“分”字段来说，其数值范围为0到59，对于“小时”字段来说其为0到23, 对于“日”字段来说为0到31, 而对于“月”字段来说为1到12。"/"字段仅仅只是帮助你在允许的数值范围内从开始"第n"的值。 因此对于“月”字段来说"7/6"只是表示7月被开启而不是“每六个月”, 请注意其中微妙的差别。

'L'字符可用在“日”和“周几”这两个字段。它是"last"的缩写, 但是在这两个字段中有不同的含义。例如,“日”字段中的"L"表示"一个月中的最后一天" —— 对于一月就是31号对于二月来说就是28号（非闰年）。而在“周几”字段中, 它简单的表示"7" or "SAT"，但是如果在“周几”字段中使用时跟在某个数字之后, 它表示"该月最后一个星期×" —— 比如"6L"表示"该月最后一个周五"。当使用'L'选项时,指定确定的列表或者范围非常重要，否则你会被结果搞糊涂的。

'W' 可用于“日”字段。用来指定历给定日期最近的工作日(周一到周五) 。比如你将“日”字段设为"15W"，意为: "离该月15号最近的工作日"。因此如果15号为周六，触发器会在14号即周五调用。如果15号为周日, 触发器会在16号也就是周一触发。如果15号为周二,那么当天就会触发。然而如果你将“日”字段设为"1W", 而一号又是周六, 触发器会于下周一也就是当月的3号触发,因为它不会越过当月的值的范围边界。'W'字符只能用于“日”字段的值为单独的一天而不是一系列值的时候。

'L'和'W'可以组合用于“日”字段表示为'LW'，意为"该月最后一个工作日"。

'#' 字符可用于“周几”字段。该字符表示“该月第几个周×”，比如"6#3"表示该月第三个周五( 6表示周五而"#3"该月第三个)。再比如: "2#1" = 表示该月第一个周一而 "4#5" = 该月第五个周三。注意如果你指定"#5"该月没有第五个“周×”，该月是不会触发的。

'C' 字符可用于“日”和“周几”字段，它是"calendar"的缩写。它表示为基于相关的日历所计算出的值（如果有的话）。如果没有关联的日历, 那它等同于包含全部日历。“日”字段值为"5C"表示"日历中的第一天或者5号及其以后"，“周几”字段值为"1C"则表示"日历中的第一天或者周日及其以后"。

对于“月份”字段和“周几”字段来说合法的字符都不是大小写敏感的。

官方文档示例：



我们在其中设置的是"0/3 * * * * ?"意思就是每天每时每隔3秒执行一次任务。我们和之前的simpleTrigger一起执行，来测试我们的配置是否成功:
重启服务器，发现控制台输出以下信息:

[plain]  view plain copy

1. ......  
2. 信息: Server startup in 16932 ms  
3. doing simpleTrigger task...2015-12-07 09:09:44  
4. doing cronTrigger task...2015-12-07 09:09:45  
5. doing simpleTrigger task...2015-12-07 09:09:46  
6. doing cronTrigger task...2015-12-07 09:09:48  
7. doing simpleTrigger task...2015-12-07 09:09:48  
8. doing simpleTrigger task...2015-12-07 09:09:50  
9. doing cronTrigger task...2015-12-07 09:09:51  
10. doing simpleTrigger task...2015-12-07 09:09:52  
11. doing cronTrigger task...2015-12-07 09:09:54  
12. doing simpleTrigger task...2015-12-07 09:09:54  
13. doing simpleTrigger task...2015-12-07 09:09:56  
14. doing cronTrigger task...2015-12-07 09:09:57  
15. doing simpleTrigger task...2015-12-07 09:09:58  
16. ......  

我们可以看到simpleTrigger和cronTrigger同时执行，而且cronTrigger是每隔3秒执行一次。
这证明我们的配置是成功的。大家可以按照上面给的配置规则来测试其他的配置，这里就不再一一测试了。

接下来我们就可以着手实现我们的需求
我们的需求是每月最后一天去自动处理尚未回复的速投请求，将没有回复的投诉设置为“已失效”。在后台管理中不能对该类型投诉进行回复。

时机：每个月月底最后一天；cronExpression:10 10 2 L * ?(凌晨2点10分10秒自动处理，为了避开工作高峰时间)
执行什么内容：对本月之前的待受理投诉进行自动处理；将投诉信息的状态改为 已失效
如何执行：
本月之前的待受理投诉：select * from Complain where 投诉时间 < 本月1号0时0分0秒


首先在我们的“投诉”模块的包下的spring配置文件中加入我们的配置:

[html]  view plain copy

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <beans xmlns="http://www.springframework.org/schema/beans"  
3.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p"  
4.     xmlns:context="http://www.springframework.org/schema/context"  
5.     xmlns:aop="http://www.springframework.org/schema/aop" xmlns:tx="http://www.springframework.org/schema/tx"  
6.     xsi:schemaLocation=" http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd   
7.     http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.0.xsd   
8.     http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.0.xsd  
9.     http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd">  
10.       
11.     <!-- 继承了注入sessionFactory的抽象类，不用反复出入sessionFactory -->  
12.     <bean id="complainDao" class="cn.edu.hpu.tax.complain.dao.impl.ComplainDaoImpl" parent="xDao"></bean>  
13.       
14.     <!-- 扫描Service -->  
15.     <context:component-scan base-package="cn.edu.hpu.tax.complain.service.impl"></context:component-scan>  
16.       
17.     <!-- 1.指定任务详细信息 -->  
18.     <bean id="complainJobDetail" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">  
19.         <!--  ① 设置执行对象 -->  
20.         <property name="targetObject" ref="complainService"></property>  
21.         <!--  ② 设置执行对象中对应的执行方法 -->  
22.         <property name="targetMethod" value="autoDeal"></property>  
23.         <!--  ③ 是否可以同步执行(这里设置不同步执行) -->  
24.         <property name="concurrent" value="false"></property>  
25.     </bean>  
26.     
27.     <!-- 2.制定任务执行时机(任务执行触发器) -->  
28.     <bean id="complainCronTrigger" class="org.springframework.scheduling.quartz.CronTriggerBean">  
29.         <!-- 设置任务详细 -->  
30.         <property name="jobDetail" ref="complainJobDetail"></property>  
31.         <!-- 设置任务执行时机，cron表达式 -->  
32.         <property name="cronExpression" value="10 10 2 L * ?"></property>  
33.     </bean>  
34.       
35.     <!-- 3.设置调度工厂 -->  
36.     <bean class="org.springframework.scheduling.quartz.SchedulerFactoryBean">  
37.         <property name="triggers">  
38.             <list>  
39.                 <!-- 触发器 -->  
40.                 <ref bean="complainCronTrigger"/>  
41.             </list>  
42.         </property>  
43.     </bean>  
44.       
45. </beans>  

然后我们可以看到，我们的任务执行类是complainService，其中任务执行方法是autoDetail方法，我们下面在complainService类中去编写autoDetail方法:
接口中定义此方法:

[java]  view plain copy

1. package cn.edu.hpu.tax.complain.service;  
2.   
3. import cn.edu.hpu.tax.complain.entity.Complain;  
4. import cn.edu.hpu.tax.core.service.BaseService;  
5.   
6. public interface ComplainService extends BaseService<Complain> {  
7.   
8.     //自动受理投诉  
9.     public void autoDeal();  
10.       
11. }  

首先类中实现该方法:

[java]  view plain copy

1. package cn.edu.hpu.tax.complain.service.impl;  
2.   
3. import java.util.Calendar;  
4. import java.util.List;  
5.   
6. import javax.annotation.Resource;  
7.   
8. import org.springframework.stereotype.Service;  
9.   
10. import cn.edu.hpu.tax.complain.dao.ComplainDao;  
11. import cn.edu.hpu.tax.complain.entity.Complain;  
12. import cn.edu.hpu.tax.complain.service.ComplainService;  
13. import cn.edu.hpu.tax.core.service.impl.BaseServiceImpl;  
14. import cn.edu.hpu.tax.core.util.QueryHelper;  
15.   
16. @Service("complainService")  
17. public class ComplainServiceImpl extends BaseServiceImpl<Complain> implements  
18.         ComplainService {  
19.   
20.     private ComplainDao complainDao;  
21.       
22.     @Resource  
23.     public void setComplainDao(ComplainDao complainDao) {  
24.         super.setBaseDao(complainDao);  
25.         this.complainDao = complainDao;  
26.     }  
27.   
28.     @Override  
29.     public void autoDeal() {  
30.         //1、查询本月之前的待受理的投诉列表  
31.         QueryHelper queryHelper=new QueryHelper(Complain.class,"c");  
32.         queryHelper.addCondition("c.state=?",Complain.COMPLAIN_STATE_UNDONE);  
33.           
34.         Calendar cal=Calendar.getInstance();  
35.         cal.set(Calendar.DAY_OF_MONTH, 1);//设置当前时间的日期为1号  
36.         cal.set(Calendar.HOUR_OF_DAY, 0);//设置当前时间的日期为0时  
37.         cal.set(Calendar.MINUTE, 0);//设置当前时间的日期为0分  
38.         cal.set(Calendar.SECOND, 0);//设置当前时间的日期为0秒  
39.         queryHelper.addCondition("c.compTime < ?", cal.getTime());  
40.           
41.         List<Complain> list=findObjects(queryHelper);  
42.         if(list != null && list.size()>0){  
43.             //2、更新投诉信息的状态为已失效  
44.             for(Complain comp:list){  
45.                 comp.setState(Complain.COMPLAIN_STATE_INVALID);  
46.                 update(comp);  
47.             }  
48.         }  
49.     }  
50. }  

这样，我们每个月的月底的凌晨2点10分10秒就会自动执行complainService中的autoDeal方法，来设置本月之前的所有未回复的投诉信息为"无效的"。

然后“无效的”投诉是不能够回复的，我们在jsp中加上这个控制，使得所有无效的投诉的“回复”链接失效:

[html]  view plain copy

1. <td align="center">  
2.      <s:if test="state != 2">  
3.          <a href="javascript:doDeal('<s:property value='compId'/>')">受理</a>  
4.      </s:if>  
5. </td>  

效果:

至此，我们的quartz与simpleTrigger、CronTrigger学习完毕，月底自动回复功能也已经实现。