Quartz任務調度器

在使用 jdk 的 timer 時發現無法滿足開發需求；即無法在指定的日期進行執行任務。

這便引入一個優秀的開源任務調度框架“ quartz ”。

 

這里加入的是quartz-1.8.6版本。Quart 的官網： http://www.quartz-scheduler.org/；項目中的框架的 spring 是 spring 3.0 版本無法集成 quartz 2.x 及其后續版本；所以這里用 quartz 1.8.6 版本。

關於在spring中使用quartz，可以在spring文檔中查看，spring4.0.4文檔說，只spring3.2以后只支持quartz2.+。

 

在spring中整合Quartz進行任務調度；首先將需要用到的jar包引入項目的lib目錄下： 

“org.springframework.context.support-3.0.2.RELEASE.jar”:此包是spring根據quartz中的主要類進行再次封裝成具有bean風格的類

“quartz-1.8.6.jar”:quartz的核心包

 

要在spring 中利用quartz調度任務；需要配置三個bean1、制定任務信息 bean

•    ① 設置執行對象
•    ② 設置執行對象中對應的執行方法
•    ③ 是否可以同步執行
•  
• 2、制定任務執行時機（執行觸發器） bean
•    2.1、簡單觸發器（SimpleTrigger）
•    ① 設置任務詳細
•    ② 設置任務延遲執行時間
•    ③ 設置任務執行頻率
•  
•    2.2、任務觸發器（CronTrigger）
•    ① 設置任務詳細
•    ② 設置執行時機（cronExpression）
•     cronExpression:秒 分 時 日 月 周 年（可選）
• 3、設置任務調度工廠 bean
•    設置觸發器們

 

 

package com.intsmaze.quartz;

 

public class QuartzTask {

 

    public void doSimpleTriggerTask() {

        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");

        System.out.println("doing simpleTrigger task..." + sdf.format(new Date()));

    }

 

    public void doCronTriggerTask() {

        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");

        System.out.println("doing cronTrigger task..." + sdf.format(new Date()));

    }    

}  

 

 

1、 jobDetail 任務詳細信息；包括調用哪個類；類中的哪個方法；執行時是否可並行執行任務。

 

    <!-- 注冊一個普通bean -->

   <bean id="quartzTask" class="com.intsmaze.quartz.QuartzTask"></bean>

     

   <!-- 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>  

 

 

2、 trigger 任務調度觸發器；主要用於定義jobDetail什么時候執行。

觸發器最常用的有兩種：簡單觸發器 SimpleTrigger  和任務觸發器 CronTrigger  。
SimpleTrigger 和 jdk 的 timer 類似，只能指定任務執行以什么樣的頻率執行，但無法制定精確的執行時間。
CronTrigger 則既可以執行簡單觸發器所制定的以頻率來執行的時間，也可以制定復雜的時間計划來執行。如可制定：每個月的最后一天的 15 點來執行相關任務。

  <!-- 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>

   

 

 

3、 schedulerFactory 任務調度工廠；用於調度各個任務觸發器。

 

   <!-- 3、設置調度工廠 -->

   <bean class="org.springframework.scheduling.quartz.SchedulerFactoryBean">

           <property name="triggers">

               <list>

                   <!-- <ref bean="simplerTrigger"/> -->

                   <ref bean="cronTrigger"/>

               </list>

           </property>

   </bean>  

 

 

啟動spring容器，就會自動執行任務調度了。

 

 

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"則表示"日歷中的第一天或者周日及其以后"。

 

對於“月份”字段和“周幾”字段來說合法的字符都不是大小寫敏感的。