纳税服务系统【自动受理,Quartz任务调度】

需求

回到我们的需求：

自动投诉受理：在每个月月底最后一天对本月之前的投诉进行自动处理；将投诉信息的状态改为 已失效。在后台管理中不能对该类型投诉进行回复。

这个需求需求我们要怎么弄呢？？？？要在每个月底最后一天对本月之前的投诉进行自动处理。。。。

记得我们以前在学习Java基础的时候学过了一个Timer这么一个类，可以用规定的频率来执行我们的代码。。。使用起来是非常简单的：

但是呢，要精确到每个月的月底，这就需要我们人为去判断时间了，这就非常不方便了。

因此，我们引入了另一个非常好用的框架：Quartz

---

Quartz

这是一个优秀的开源任务调度框架“quartz”，可以简单理解成他是Timer的升级版….Spring集成了该框架…

快速入门

我们要使用它，就要导入其开发包：quartz-1.8.6.jar，和Spring对其支持的开发包：org.springframework.context.support-3.0.2.RELEASE

使用它的步骤是十分简单的，可分成三个步骤：

1、制定任务信息 bean

• ① 设置执行对象
• ② 设置执行对象中对应的执行方法
• ③ 是否可以同步执行

2、制定任务执行时机（执行触发器） bean

• 2.1、简单触发器（SimpleTrigger）

  • ① 设置任务详细
  • ② 设置任务延迟执行时间
  • ③ 设置任务执行频率

• 2.2、任务触发器（CronTrigger）

  • ① 设置任务详细
  • ② 设置执行时机（cronExpression）
  • cronExpression:秒 分 时 日 月 周 年（可选）

3、设置任务调度工厂 bean

• 设置触发器们

jobDetail任务详细信息

1、jobDetail 任务详细信息；包括调用哪个类；类中的哪个方法；执行时是否可并行执行任务。

   <!-- 1、制定任务信息信息 -->
   <bean id="jobDetail1" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">
           <!-- 设置执行对象 -->
           <property name="targetObject" ref="quartzTask"></property>
           <!-- 设置执行对象中对应的执行方法 -->
           <property name="targetMethod" value="doSimpleTriggerTask"></property>
           <!-- 是否可以同步执行；不可同步执行 -->
           <property name="concurrent" value="false"></property>
   </bean>
   <bean id="jobDetail2" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">
           <!-- 设置执行对象 -->
           <property name="targetObject" ref="quartzTask"></property>
           <!-- 设置执行对象中对应的执行方法 -->
           <property name="targetMethod" value="doCronTriggerTask"></property>
           <!-- 是否可以同步执行；不可同步执行 -->
           <property name="concurrent" value="false"></property>
   </bean>

---

trigger任务调度触发器

2、trigger 任务调度触发器；主要用于定义jobDetail什么时候执行。触发器最常用的有两种：简单触发器SimpleTrigger 和 任务触发器CronTrigger 。SimpleTrigger和jdk的timer类似，只能指定任务执行以什么样的频率执行，但无法制定精确的执行时间。CronTrigger则既可以执行简单触发器所制定的以频率来执行的时间，也可以制定复杂的时间计划来执行。

   <!-- 2、制定任务执行时机（任务执行触发器） -->
   <bean id="simplerTrigger" class="org.springframework.scheduling.quartz.SimpleTriggerBean">
        <!-- 设置任务详细 -->
        <property name="jobDetail" ref="jobDetail1"></property>
        <!-- 设置任务延迟执行时间 ；延迟2秒执行-->
        <property name="startDelay" value="2000"></property>
        <!-- 设置任务执行频率；执行频率为每4秒执行一下 -->
        <property name="repeatInterval" value="2000"></property>
   </bean>

   <bean id="cronTrigger" class="org.springframework.scheduling.quartz.CronTriggerBean">
        <!-- 设置任务详细 -->
        <property name="jobDetail" ref="jobDetail2"></property>
        <!-- 设置任务执行时机，cron表达式 -->
        <property name="cronExpression" value="* * * 18c * ?"></property>
   </bean>

这里我们着重要了解表达式怎么写：秒 分 时 日 月 周 年【日和周不能同时出现】

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

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

• ‘-’ 字符被用来指定一个值的范围，比如在“小时”字段中设为”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”则表示”日历中的第一天或者周日及其以后”。

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

---

schedulerFactory 任务调度工厂

schedulerFactory 任务调度工厂；用于调度各个任务触发器。

任务调度工厂可以调度多个任务同时进行

   <!-- 3、设置调度工厂 -->
   <bean class="org.springframework.scheduling.quartz.SchedulerFactoryBean">
        <property name="triggers">
            <list>
                <!-- <ref bean="simplerTrigger"/> -->
                <ref bean="cronTrigger"/>
            </list>
        </property>
   </bean>

---

自动受理

回到我们的需求，我们已经大概了解了Quartz这么一个开源框架使用了。我们就可以在每个月的最后一天中去执行我们对应的代码就行了。

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

在Spring配置文件中加入Quartz框架….

我们在Service中执行对应的代码：

    <!-- 1、制定任务信息信息 -->
    <bean id="jobDetail1" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">
        <!-- 设置执行对象 -->
        <property name="targetObject" ref="complainServiceImpl"></property>
        <!-- 设置执行对象中对应的执行方法 -->
        <property name="targetMethod" value="doTask"></property>
        <!-- 是否可以同步执行；不可同步执行 -->
        <property name="concurrent" value="false"></property>
    </bean>

    <!-- 2、制定任务执行时机（任务执行触发器） -->
    <bean id="cronTrigger" class="org.springframework.scheduling.quartz.CronTriggerBean">
        <!-- 设置任务详细 -->
        <property name="jobDetail" ref="jobDetail1"></property>
        <!-- 设置任务执行时机，cron表达式 -->
        <property name="cronExpression" value="10 10 2 L * ?"></property>
    </bean>

    <!-- 3、设置调度工厂 -->
    <bean class="org.springframework.scheduling.quartz.SchedulerFactoryBean">
        <property name="triggers">
            <list>
                <ref bean="cronTrigger"/>
            </list>
        </property>
    </bean>
</beans>

查询出未处理和是本月前的记录，修改成是失效的。

    @Override
    public void doTask() {

        //查询所有待受理的信息
        QueryHelper queryHelper = new QueryHelper(Complain.class, "c");
        queryHelper.addCondition("  c.state=?", Complain.COMPLAIN_STATE_UNDONE);

        //只要在本月之前
        Calendar calendar = Calendar.getInstance();
        calendar.set(Calendar.DAY_OF_MONTH, 1);
        calendar.set(Calendar.HOUR_OF_DAY, 0);
        calendar.set(Calendar.MINUTE, 0);
        calendar.set(Calendar.SECOND, 0);
        queryHelper.addCondition(" c.compTime <?", calendar.getTime());

        //拿到本月之前所有未处理的数据
        List<Complain> complains = findObjects(queryHelper);

        //将数据全部改成是失效的了。
        for (Complain complain : complains) {
            complain.setState(Complain.COMPLAIN_STATE_INVALID);
        }
    }
}

如果已经失效了，那么我们就不让管理员对其进行回复了。

      <s:if test="state!=2"> <a href="javascript:doDeal('<s:property value='compId'/>')">受理</a></s:if>

---