Quartz入門案例與介紹（與spring整合）

標籤：去除   context   table   區分大小寫   XML   cto   sep   一個   images   

　　Quartz概述

　　Quartz是OpenSymphony開源組織在Job scheduling領域又一個開源項目，它可以與J2EE與J2SE應用程式相結合也可以單獨使用。Quartz可以用來建立簡單或為運行十個，百個，甚至是好幾萬個Jobs這樣複雜的程式。Jobs可以做成標準的Java組件或 EJBs。

　　官網：http://www.quartz-scheduler.org/downloads/

　　下載好後是這樣一個壓縮包 

　　解壓壓縮包得到以下目錄檔案

 　　首先，建立一個java工程

　　第二步，匯入相關的jar包

 

 

　　第三步，建立作業類

1 public class TestQuartz {2     public void run(){3         System.out.println(new SimpleDateFormat("任務執行了"+"yyyy-MM-dd HH:mm:ss").format(new Date()));4     }5 }

　　第四步：在spring設定檔中配置作業類

<!-- 配置作業類 --><bean id="myJob" class="com.test.job.MyJob"/>

　　第五步：在spring設定檔中配置JobDetail

<!-- 配置JobDetail（作業詳情） --><bean id="myJobDetail" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">    <!-- 用到的job執行個體 -->    <property name="targetObject" ref="myJob"/>    <!-- job執行個體中的方法 -->    <property name="targetMethod">        <value>run</value>    </property></bean>

　　第六步：在spring設定檔中配置觸發器（cron運算式下面會有詳細講解）

<!-- 配置觸發器Trigger --><bean id="myTrigger" class="org.springframework.scheduling.quartz.CronTriggerFactoryBean">    <property name="jobDetail" ref="myJobDetail"/>    <property name="cronExpression">        <!-- 配置cron運算式，每5秒執行一次 -->        <value>0/5 * * * * ?</value>    </property></bean>

 

　   第七步：在spring設定檔中配置scheduler

<!-- 配置scheduler工廠 --><bean id="scheduler" class="org.springframework.scheduling.quartz.SchedulerFactoryBean">    <property name="triggers">        <list>            <ref bean="myTrigger"/>        </list>    </property></bean>

　   第八步：載入spring設定檔，建立spring工廠

public class TestQuartz {    public static void main(String[] args) {        ClassPathXmlApplicationContext classPathXmlApplicationContext = new ClassPathXmlApplicationContext("applicationContext.xml");    }}

　　到此時，一運行main方法，就成功運行了，每5秒調用一次run方法

　

　　核心概念

　　1、scheduler是一個計劃調度器容器，容器裡面可以盛放眾多的JobDetail和trigger，當容器啟動後，裡面的每個JobDetail都會根據trigger按部就班自動去執行。

　　2、JobDetail是一個可執行檔工作，它本身可能是有狀態的。

　　3、Trigger觸發器代表一個調度參數的配置，什麼時候去調。

　　4、當JobDetail和Trigger在scheduler容器上註冊後，形成了裝配好的作業（JobDetail和Trigger所組成的一對兒），就可以伴隨容器啟動而調度執行了。

　　5、scheduler是個容器，容器中有一個線程池，用來並行調度執行每個作業，這樣可以提高容器效率。

 

　　cron 運算式的格式　

　

　　（1）Quartz cron 的格式向下支援到秒層級的計劃。

　　（2）Quartz 用 cron 運算式存放執行計畫。引用了 cron 運算式的 CronTrigger 在計劃的時間裡會與 job 關聯上。

　　（3）Quartz 提供七個域，每個域的含義如下

　

　　下表列出了 Quartz cron 運算式支援的七個域。

　　Quartz Cron 運算式支援到七個域 

名稱	是否必須	允許值	特殊字元
秒	是	0-59	, - * /
分	是	0-59	, - * /
時	是	0-23	, - * /
日	是	1-31	, - * ? / L W C
月	是	1-12 或 JAN-DEC	, - * /
周	是	1-7 或 SUN-SAT	, - * ? / L C #
年	否	空 或 1970-2099	, - * /

　　注意： （1）月份和星期的名稱是不區分大小寫。FRI 和 fri是一樣的。 

　　　　　（2）域之間有空格分隔，我們能寫的最簡單的運算式看起來就是這個了：

　　　　　　　　 * * * ? * * 
　　　　　　　　這個表達會每秒鐘激發一個部署的 job。 

·理解特殊字元 

　　* 星號 

　　使用星號(*) 指示著你想在這個域上包含所有合法的值。例如，在月份域上使用星號意味著每個月都會觸發這個 trigger。

　　運算式範例： 

　　0 * 17 * * ? 

　　意義：每天從下午5點到下午5:59中的每分鐘激發一次 trigger。它停在下午5:59 是因為值 17 在小時域上，在下午 6 點時，小時變為 18 了，也就不再理會這個trigger，直到下一天的下午5點。 

　　在你希望 trigger 在該域的所有有效值上被激發時使用* 字元。 

　　? 問號 

　　? 號只能用在日和周域上，但是不能在這兩個域上同時使用。你可以認為 ? 字元是"我並不關心在該域上是什麼值。" 這不同於星號，星號是指示著該域上的每一個值。? 是說不為該域指定值。 

　　不能同時這兩個域上指定值的理由是難以解釋甚至是難以理解的。基本上，假定同時指定值的話，意義就會變得含混不清了：考慮一下，如果一個運算式在日域上有值11，同時在周域上指定了 WED。那麼是要 trigger 僅在每個月的11號，且正好又是星期三那天被激發？還是在每個星期三的11號被激發呢？要去除這種不明確性的辦法就是不能同時在這兩個域上指定值。 

　　只要記住，假如你為這兩域的其中一個指定了值，那就必須在另一個字值上放一個 ?。 

　　運算式範例： 

　　0 10,44 14 ? 3 WEB 

　　意義：在三月中的每個星期三的下午 2:10 和 下午 2:44 被觸發。 

　　, 逗號 

　　逗號 (,) 是用來在給某個域上指定一個值列表的。例如，使用值 0,15,30,45 在秒域上意味著每15秒觸發一個 trigger。 

　　運算式範例： 

　　0 0,15,30,45 * * * ? 

　　意義：每刻鐘觸發一次 trigger。 

　　/ 斜杠 

　　斜杠 (/) 是用於時間表的遞增的。我們剛剛用了逗號來表示每15分鐘的遞增，但是我們也能寫成這樣0/15。 

　　運算式範例： 

　　0/15 0/30 * * * ? 

　　意義：在整點和半點鐘時每15秒觸發trigger。 

　　- 中劃線 

　　中劃線 (-) 用於指定一個範圍。例如，在小時域上的 3-8 意味著"3,4,5,6,7 和 8 點。" 域的值不允許回卷，所以像 50-10 這樣的值是不允許的。 

　　運算式範例： 

　　0 45 3-8 ? * * 

　　意義：在上午的3點至上午的8點的45分時觸發trigger。 

　　L 字母

　　L 說明了某域上允許的最後一個值。它僅被日和周域支援。當用在日域上，表示的是在月域上指定的月份的最後一天。例如，當月域上指定了 JAN 時，在日域上的 L 會促使 trigger 在1月31號被觸發。假如月域上是 SEP，那麼 L 會預示著在9月30號觸發。換句話說，就是不管指定了哪個月，都是在相應月份的時最後一天觸發 trigger。 

　　運算式 0 0 8 L * ? 意義是在每個月最後一天的上午8:00 觸發 trigger。在月域上的 * 說明是 "每個月"。 

　　當 L 字母用於周域上，指示著周的最後一天，就是星期六 (或者數字7)。所以如果你需要在每個月的最後一個星期六下午的 11:59 觸發trigger，你可以用這樣的運算式 0 59 23 ? * L。 

　　當使用於周域上，你可以用一個數字與 L 連起來表示月份的最後一個星期X。例如，運算式 0 0 12 ? * 2L 說的是在每個月的最後一個星期一觸發 trigger。 

不要讓範圍和列表值與 L 連用 雖然你能用星期數(1-7)與 L 連用，但是不允許你用一個範圍值和列表值與 L 連用。這會產生不可預知的結果。

　　W 字母 

　　W 字元代表著平日 (Mon-Fri)，並且僅能用於日域中。它用來指定離指定日的最近的一個平日。大部分的商業處理都是基於工作周的，所以 W 字元可能是非常重要的。例如，日域中的 15W 意味著"離該月15號的最近一個平日。"假如15號是星期六，那麼trigger 會在14號(星期四)觸發，因為距15號最近的是星期一，這個例子中也會是17號（譯者Unmi註：不會在17號觸發的，如果是15W，可能會是在14號(15號是星期六)或者15號(15號是星期天)觸發，也就是只能出現在鄰近的一天，如果15號當天為平日直接就會當日執行）。W只能用在指定的日域為單天，不能是範圍或列表值。 

　　# 井號 

　　# 字元僅能用於周域中。它用於指定月份中的第幾周的哪一天。例如，如果你指定周域的值為 6#3，它意思是某月的第三個周五(6=星期五，#3意味著月份中的第三周)。另一個例子 2#1 意思是某月的第一個星期一 (2=星期一，#1意味著月份中的第一周)。注意，假如你指定 #5，然而月份中沒有第 5 周，那麼該月不會觸發。

　　樣本：運算式意義

　　"00 12 * *?" 每天中午12點觸發

　　"015 10 ? **" 每天上午10:15觸發

　　"015 10 * *?" 每天上午10:15觸發

　　"015 10 * * ?*" 每天上午10:15觸發

　　"015 10 * * ?2005" 2005年的每天上午10:15觸發

　　"0* 14 * *?" 在每天下午2點到下午2:59期間的每1分鐘觸發

　　"00/5 14 * *?" 在每天下午2點到下午2:55期間的每5分鐘觸發

　　"00/5 14,18 ** ?" 在每天下午2點到2:55期間和下午6點到6:55期間的每5分鐘觸發

　　"00-5 14 * *?" 在每天下午2點到下午2:05期間的每1分鐘觸發

　　"010,44 14 ? 3WED" 每年三月的星期三的下午2:10和2:44觸發

　　"015 10 ? *MON-FRI" 周一至周五的上午10:15觸發

　　"015 10 15 *?" 每月15日上午10:15觸發

　　"015 10 L *?" 每月最後一日的上午10:15觸發

　　"015 10 ? *6L" 每月的最後一個星期五上午10:15觸發

　　"015 10 ? * 6L2002-2005" 2002年至2005年的每月的最後一個星期五上午10:15觸發

　　"015 10 ? *6#3" 每月的第三個星期五上午10:15觸發

　

Quartz入門案例與介紹（與spring整合）