概述

了解Quartz體系結(jié)構(gòu)

Quartz對(duì)任務(wù)調(diào)度的領(lǐng)域問題進(jìn)行了高度的抽象，提出了調(diào)度器、任務(wù)和觸發(fā)器這3個(gè)核心的概念，并在org.quartz通過接口和類對(duì)重要的這些核心概念進(jìn)行描述：

●Job：是一個(gè)接口，只有一個(gè)方法void execute(JobExecutionContext context)，開發(fā)者實(shí)現(xiàn)該接口定義運(yùn)行任務(wù)，JobExecutionContext類提供了調(diào)度上下文的各種信息。Job運(yùn)行時(shí)的信息保存在JobDataMap實(shí)例中；

●JobDetail：Quartz在每次執(zhí)行Job時(shí)，都重新創(chuàng)建一個(gè)Job實(shí)例，所以它不直接接受一個(gè)Job的實(shí)例，相反它接收一個(gè)Job實(shí)現(xiàn)類，以便運(yùn)行時(shí)通過newInstance()的反射機(jī)制實(shí)例化Job。因此需要通過一個(gè)類來描述Job的實(shí)現(xiàn)類及其它相關(guān)的靜態(tài)信息，如Job名字、描述、關(guān)聯(lián)監(jiān)聽器等信息，JobDetail承擔(dān)了這一角色。

通過該類的構(gòu)造函數(shù)可以更具體地了解它的功用：JobDetail(java.lang.String name, java.lang.String group, java.lang.Class jobClass)，該構(gòu)造函數(shù)要求指定Job的實(shí)現(xiàn)類，以及任務(wù)在Scheduler中的組名和Job名稱；

●Trigger：是一個(gè)類，描述觸發(fā)Job執(zhí)行的時(shí)間觸發(fā)規(guī)則。主要有SimpleTrigger和CronTrigger這兩個(gè)子類。當(dāng)僅需觸發(fā)一次或者以固定時(shí)間間隔周期執(zhí)行，SimpleTrigger是最適合的選擇；而CronTrigger則可以通過Cron表達(dá)式定義出各種復(fù)雜時(shí)間規(guī)則的調(diào)度方案：如每早晨9:00執(zhí)行，周一、周三、周五下午5:00執(zhí)行等；

●Calendar：org.quartz.Calendar和java.util.Calendar不同，它是一些日歷特定時(shí)間點(diǎn)的集合（可以簡(jiǎn)單地將org.quartz.Calendar看作java.util.Calendar的集合——java.util.Calendar代表一個(gè)日歷時(shí)間點(diǎn)，無特殊說明后面的Calendar即指org.quartz.Calendar）。一個(gè)Trigger可以和多個(gè)Calendar關(guān)聯(lián)，以便排除或包含某些時(shí)間點(diǎn)。

假設(shè)，我們安排每周星期一早上10:00執(zhí)行任務(wù)，但是如果碰到法定的節(jié)日，任務(wù)則不執(zhí)行，這時(shí)就需要在Trigger觸發(fā)機(jī)制的基礎(chǔ)上使用Calendar進(jìn)行定點(diǎn)排除。針對(duì)不同時(shí)間段類型，Quartz在org.quartz.impl.calendar包下提供了若干個(gè)Calendar的實(shí)現(xiàn)類，如AnnualCalendar、MonthlyCalendar、WeeklyCalendar分別針對(duì)每年、每月和每周進(jìn)行定義；

●Scheduler：代表一個(gè)Quartz的獨(dú)立運(yùn)行容器，Trigger和JobDetail可以注冊(cè)到Scheduler中，兩者在Scheduler中擁有各自的組及名稱，組及名稱是Scheduler查找定位容器中某一對(duì)象的依據(jù)，Trigger的組及名稱必須唯一，JobDetail的組和名稱也必須唯一（但可以和Trigger的組和名稱相同，因?yàn)樗鼈兪遣煌愋偷模?。Scheduler定義了多個(gè)接口方法，允許外部通過組及名稱訪問和控制容器中Trigger和JobDetail。

Scheduler可以將Trigger綁定到某一JobDetail中，這樣當(dāng)Trigger觸發(fā)時(shí)，對(duì)應(yīng)的Job就被執(zhí)行。一個(gè)Job可以對(duì)應(yīng)多個(gè)Trigger，但一個(gè)Trigger只能對(duì)應(yīng)一個(gè)Job。可以通過SchedulerFactory創(chuàng)建一個(gè)Scheduler實(shí)例。Scheduler擁有一個(gè)SchedulerContext，它類似于ServletContext，保存著Scheduler上下文信息，Job和Trigger都可以訪問SchedulerContext內(nèi)的信息。SchedulerContext內(nèi)部通過一個(gè)Map，以鍵值對(duì)的方式維護(hù)這些上下文數(shù)據(jù)，SchedulerContext為保存和獲取數(shù)據(jù)提供了多個(gè)put()和getXxx()的方法?？梢酝ㄟ^Scheduler# getContext()獲取對(duì)應(yīng)的SchedulerContext實(shí)例；

●ThreadPool：Scheduler使用一個(gè)線程池作為任務(wù)運(yùn)行的基礎(chǔ)設(shè)施，任務(wù)通過共享線程池中的線程提高運(yùn)行效率。

Job有一個(gè)StatefulJob子接口，代表有狀態(tài)的任務(wù)，該接口是一個(gè)沒有方法的標(biāo)簽接口，其目的是讓Quartz知道任務(wù)的類型，以便采用不同的執(zhí)行方案。無狀態(tài)任務(wù)在執(zhí)行時(shí)擁有自己的JobDataMap拷貝，對(duì)JobDataMap的更改不會(huì)影響下次的執(zhí)行。而有狀態(tài)任務(wù)共享共享同一個(gè)JobDataMap實(shí)例，每次任務(wù)執(zhí)行對(duì)JobDataMap所做的更改會(huì)保存下來，后面的執(zhí)行可以看到這個(gè)更改，也即每次執(zhí)行任務(wù)后都會(huì)對(duì)后面的執(zhí)行發(fā)生影響。

正因?yàn)檫@個(gè)原因，無狀態(tài)的Job可以并發(fā)執(zhí)行，而有狀態(tài)的StatefulJob不能并發(fā)執(zhí)行，這意味著如果前次的StatefulJob還沒有執(zhí)行完畢，下一次的任務(wù)將阻塞等待，直到前次任務(wù)執(zhí)行完畢。有狀態(tài)任務(wù)比無狀態(tài)任務(wù)需要考慮更多的因素，程序往往擁有更高的復(fù)雜度，因此除非必要，應(yīng)該盡量使用無狀態(tài)的Job。

如果Quartz使用了數(shù)據(jù)庫持久化任務(wù)調(diào)度信息，無狀態(tài)的JobDataMap僅會(huì)在Scheduler注冊(cè)任務(wù)時(shí)保持一次，而有狀態(tài)任務(wù)對(duì)應(yīng)的JobDataMap在每次執(zhí)行任務(wù)后都會(huì)進(jìn)行保存。

Trigger自身也可以擁有一個(gè)JobDataMap，其關(guān)聯(lián)的Job可以通過JobExecutionContext#getTrigger().getJobDataMap()獲取Trigger中的JobDataMap。不管是有狀態(tài)還是無狀態(tài)的任務(wù)，在任務(wù)執(zhí)行期間對(duì)Trigger的JobDataMap所做的更改都不會(huì)進(jìn)行持久，也即不會(huì)對(duì)下次的執(zhí)行產(chǎn)生影響。

Quartz擁有完善的事件和監(jiān)聽體系，大部分組件都擁有事件，如任務(wù)執(zhí)行前事件、任務(wù)執(zhí)行后事件、觸發(fā)器觸發(fā)前事件、觸發(fā)后事件、調(diào)度器開始事件、關(guān)閉事件等等，可以注冊(cè)相應(yīng)的監(jiān)聽器處理感興趣的事件。

圖1描述了Scheduler的內(nèi)部組件結(jié)構(gòu)，SchedulerContext提供Scheduler全局可見的上下文信息，每一個(gè)任務(wù)都對(duì)應(yīng)一個(gè)JobDataMap，虛線表達(dá)的JobDataMap表示對(duì)應(yīng)有狀態(tài)的任務(wù)：

500){this.resized=true;this.style.width=500;}" align=center>

圖1 Scheduler結(jié)構(gòu)圖

一個(gè)Scheduler可以擁有多個(gè)Triger組和多個(gè)JobDetail組，注冊(cè)Trigger和JobDetail時(shí)，如果不顯式指定所屬的組，Scheduler將放入到默認(rèn)組中，默認(rèn)組的組名為Scheduler.DEFAULT_GROUP。組名和名稱組成了對(duì)象的全名，同一類型對(duì)象的全名不能相同。

Scheduler本身就是一個(gè)容器，它維護(hù)著Quartz的各種組件并實(shí)施調(diào)度的規(guī)則。Scheduler還擁有一個(gè)線程池，線程池為任務(wù)提供執(zhí)行線程——這比執(zhí)行任務(wù)時(shí)簡(jiǎn)單地創(chuàng)建一個(gè)新線程要擁有更高的效率，同時(shí)通過共享節(jié)約資源的占用。通過線程池組件的支持，對(duì)于繁忙度高、壓力大的任務(wù)調(diào)度，Quartz將可以提供良好的伸縮性。

提示： Quartz完整下載包examples目錄下?lián)碛?0多個(gè)實(shí)例，它們是快速掌握Quartz應(yīng)用很好的實(shí)例。

使用SimpleTrigger

SimpleTrigger擁有多個(gè)重載的構(gòu)造函數(shù)，用以在不同場(chǎng)合下構(gòu)造出對(duì)應(yīng)的實(shí)例：

●SimpleTrigger(String name, String group)：通過該構(gòu)造函數(shù)指定Trigger所屬組和名稱；

●SimpleTrigger(String name, String group, Date startTime)：除指定Trigger所屬組和名稱外，還可以指定觸發(fā)的開發(fā)時(shí)間；

●SimpleTrigger(String name, String group, Date startTime, Date endTime, int repeatCount, long repeatInterval)：除指定以上信息外，還可以指定結(jié)束時(shí)間、重復(fù)執(zhí)行次數(shù)、時(shí)間間隔等參數(shù)；

●SimpleTrigger(String name, String group, String jobName, String jobGroup, Date startTime, Date endTime, int repeatCount, long repeatInterval)：這是最復(fù)雜的一個(gè)構(gòu)造函數(shù)，在指定觸發(fā)參數(shù)的同時(shí)，還通過jobGroup和jobName，讓該Trigger和Scheduler中的某個(gè)任務(wù)關(guān)聯(lián)起來。

通過實(shí)現(xiàn) org.quartz..Job 接口，可以使 Java 類化身為可調(diào)度的任務(wù)。代碼清單1提供了 Quartz 任務(wù)的一個(gè)示例：

代碼清單1 SimpleJob：簡(jiǎn)單的Job實(shí)現(xiàn)類

package com.baobaotao.basic.quartz;

import java.util.Date;

import org.quartz.Job;

import org.quartz.JobExecutionContext;

import org.quartz.JobExecutionException;

public class SimpleJob implements Job {

①實(shí)例Job接口方法

public void execute(JobExecutionContext jobCtx)throws JobExecutionException {

System.out.println(jobCtx.getTrigger().getName()+ " triggered. time is:" + (new Date()));

}

}

這個(gè)類用一條非常簡(jiǎn)單的輸出語句實(shí)現(xiàn)了Job接口的execute(JobExecutionContext context) 方法，這個(gè)方法可以包含想要執(zhí)行的任何代碼。下面，我們通過SimpleTrigger對(duì)SimpleJob進(jìn)行調(diào)度：

代碼清單2 SimpleTriggerRunner：使用SimpleTrigger進(jìn)行調(diào)度

package com.baobaotao.basic.quartz;

import java.util.Date;

import org.quartz.JobDetail;

import org.quartz.Scheduler;

import org.quartz.SchedulerFactory;

import org.quartz.SimpleTrigger;

import org.quartz.impl.StdSchedulerFactory;

public class SimpleTriggerRunner {

public static void main(String args[]) {

try {

①創(chuàng)建一個(gè)JobDetail實(shí)例，指定SimpleJob

JobDetail jobDetail = new JobDetail("job1_1","jGroup1", SimpleJob.class);

②通過SimpleTrigger定義調(diào)度規(guī)則：馬上啟動(dòng)，每2秒運(yùn)行一次，共運(yùn)行100次

SimpleTrigger simpleTrigger = new SimpleTrigger("trigger1_1","tgroup1");

simpleTrigger.setStartTime(new Date());

simpleTrigger.setRepeatInterval(2000);

simpleTrigger.setRepeatCount(100);

③通過SchedulerFactory獲取一個(gè)調(diào)度器實(shí)例

SchedulerFactory schedulerFactory = new StdSchedulerFactory();

Scheduler scheduler = schedulerFactory.getScheduler();

scheduler.scheduleJob(jobDetail, simpleTrigger);④ 注冊(cè)并進(jìn)行調(diào)度

scheduler.start();⑤調(diào)度啟動(dòng)

} catch (Exception e) {

e.printStackTrace();

}

}

}

首先在①處通過JobDetail封裝SimpleJob，同時(shí)指定Job在Scheduler中所屬組及名稱，這里，組名為jGroup1，而名稱為job1_1。

在②處創(chuàng)建一個(gè)SimpleTrigger實(shí)例，指定該Trigger在Scheduler中所屬組及名稱。接著設(shè)置調(diào)度的時(shí)間規(guī)則。

最后，需要?jiǎng)?chuàng)建Scheduler實(shí)例，并將JobDetail和Trigger實(shí)例注冊(cè)到Scheduler中。這里，我們通過StdSchedulerFactory獲取一個(gè)Scheduler實(shí)例，并通過scheduleJob(JobDetail jobDetail, Trigger trigger)完成兩件事：

1)將JobDetail和Trigger注冊(cè)到Scheduler中；

2)將Trigger指派給JobDetail，將兩者關(guān)聯(lián)起來。

當(dāng)Scheduler啟動(dòng)后，Trigger將定期觸發(fā)并執(zhí)行SimpleJob的execute(JobExecutionContext jobCtx)方法，然后每 10 秒重復(fù)一次，直到任務(wù)被執(zhí)行 100 次后停止。

還可以通過SimpleTrigger的setStartTime(java.util.Date startTime)和setEndTime(java.util.Date endTime)指定運(yùn)行的時(shí)間范圍，當(dāng)運(yùn)行次數(shù)和時(shí)間范圍沖突時(shí)，超過時(shí)間范圍的任務(wù)運(yùn)行不被執(zhí)行。如可以通過simpleTrigger.setStartTime(new Date(System.currentTimeMillis() + 60000L))指定60秒鐘以后開始。

除了通過scheduleJob(jobDetail, simpleTrigger)建立Trigger和JobDetail的關(guān)聯(lián)，還有另外一種關(guān)聯(lián)Trigger和JobDetail的方式：

JobDetail jobDetail = new JobDetail("job1_1","jGroup1", SimpleJob.class);

SimpleTrigger simpleTrigger = new SimpleTrigger("trigger1_1","tgroup1");

…

simpleTrigger.setJobGroup("jGroup1");①-1：指定關(guān)聯(lián)的Job組名

simpleTrigger.setJobName("job1_1");①-2：指定關(guān)聯(lián)的Job名稱

scheduler.addJob(jobDetail, true);② 注冊(cè)JobDetail

scheduler.scheduleJob(simpleTrigger);③ 注冊(cè)指定了關(guān)聯(lián)JobDetail的Trigger

在這種方式中，Trigger通過指定Job所屬組及Job名稱，然后使用Scheduler的scheduleJob(Trigger trigger)方法注冊(cè)Trigger。有兩個(gè)值得注意的地方：

通過這種方式注冊(cè)的Trigger實(shí)例必須已經(jīng)指定Job組和Job名稱，否則調(diào)用注冊(cè)Trigger的方法將拋出異常；

引用的JobDetail對(duì)象必須已經(jīng)存在于Scheduler中。也即，代碼中①、②和③的先后順序不能互換。

在構(gòu)造Trigger實(shí)例時(shí)，可以考慮使用org.quartz.TriggerUtils工具類，該工具類不但提供了眾多獲取特定時(shí)間的方法，還擁有眾多獲取常見Trigger的方法，如makeSecondlyTrigger(String trigName)方法將創(chuàng)建一個(gè)每秒執(zhí)行一次的Trigger，而makeWeeklyTrigger(String trigName, int dayOfWeek, int hour, int minute)將創(chuàng)建一個(gè)每星期某一特定時(shí)間點(diǎn)執(zhí)行一次的Trigger。而getEvenMinuteDate(Date date)方法將返回某一時(shí)間點(diǎn)一分鐘以后的時(shí)間。

使用CronTrigger

CronTrigger 能夠提供比 SimpleTrigger 更有具體實(shí)際意義的調(diào)度方案，調(diào)度規(guī)則基于 Cron 表達(dá)式，CronTrigger 支持日歷相關(guān)的重復(fù)時(shí)間間隔（比如每月第一個(gè)周一執(zhí)行），而不是簡(jiǎn)單的周期時(shí)間間隔。因此，相對(duì)于SimpleTrigger而言，CronTrigger在使用上也要復(fù)雜一些。

Cron表達(dá)式

Quartz使用類似于Linux下的Cron表達(dá)式定義時(shí)間規(guī)則，Cron表達(dá)式由6或7個(gè)由空格分隔的時(shí)間字段組成，如表1所示：

表1 Cron表達(dá)式時(shí)間字段

位置	時(shí)間域名	允許值	允許的特殊字符
1	秒	0-59	, - * /
2	分鐘	0-59	, - * /
3	小時(shí)	0-23	, - * /
4	日期	1-31	, - * ? / L W C
5	月份	1-12	, - * /
6	星期	1-7	, - * ? / L C #
7	年(可選)	空值1970-2099	, - * /

Cron表達(dá)式的時(shí)間字段除允許設(shè)置數(shù)值外，還可使用一些特殊的字符，提供列表、范圍、通配符等功能，細(xì)說如下：

●星號(hào)(*)：可用在所有字段中，表示對(duì)應(yīng)時(shí)間域的每一個(gè)時(shí)刻，例如，*在分鐘字段時(shí)，表示“每分鐘”；

●問號(hào)（?）：該字符只在日期和星期字段中使用，它通常指定為“無意義的值”，相當(dāng)于點(diǎn)位符；

●減號(hào)(-)：表達(dá)一個(gè)范圍，如在小時(shí)字段中使用“10-12”，則表示從10到12點(diǎn)，即10,11,12；

●逗號(hào)(,)：表達(dá)一個(gè)列表值，如在星期字段中使用“MON,WED,FRI”，則表示星期一，星期三和星期五；

●斜杠(/)：x/y表達(dá)一個(gè)等步長(zhǎng)序列，x為起始值，y為增量步長(zhǎng)值。如在分鐘字段中使用0/15，則表示為0,15,30和45秒，而5/15在分鐘字段中表示5,20,35,50，你也可以使用*/y，它等同于0/y；

●L：該字符只在日期和星期字段中使用，代表“Last”的意思，但它在兩個(gè)字段中意思不同。L在日期字段中，表示這個(gè)月份的最后一天，如一月的31號(hào)，非閏年二月的28號(hào)；如果L用在星期中，則表示星期六，等同于7。但是，如果L出現(xiàn)在星期字段里，而且在前面有一個(gè)數(shù)值X，則表示“這個(gè)月的最后X天”，例如，6L表示該月的最后星期五；

●W：該字符只能出現(xiàn)在日期字段里，是對(duì)前導(dǎo)日期的修飾，表示離該日期最近的工作日。例如15W表示離該月15號(hào)最近的工作日，如果該月15號(hào)是星期六，則匹配14號(hào)星期五；如果15日是星期日，則匹配16號(hào)星期一；如果15號(hào)是星期二，那結(jié)果就是15號(hào)星期二。但必須注意關(guān)聯(lián)的匹配日期不能夠跨月，如你指定1W，如果1號(hào)是星期六，結(jié)果匹配的是3號(hào)星期一，而非上個(gè)月最后的那天。W字符串只能指定單一日期，而不能指定日期范圍；

●LW組合：在日期字段可以組合使用LW，它的意思是當(dāng)月的最后一個(gè)工作日；

●井號(hào)(#)：該字符只能在星期字段中使用，表示當(dāng)月某個(gè)工作日。如6#3表示當(dāng)月的第三個(gè)星期五(6表示星期五，#3表示當(dāng)前的第三個(gè))，而4#5表示當(dāng)月的第五個(gè)星期三，假設(shè)當(dāng)月沒有第五個(gè)星期三，忽略不觸發(fā)；

● C：該字符只在日期和星期字段中使用，代表“Calendar”的意思。它的意思是計(jì)劃所關(guān)聯(lián)的日期，如果日期沒有被關(guān)聯(lián)，則相當(dāng)于日歷中所有日期。例如5C在日期字段中就相當(dāng)于日歷5日以后的第一天。1C在星期字段中相當(dāng)于星期日后的第一天。

Cron表達(dá)式對(duì)特殊字符的大小寫不敏感，對(duì)代表星期的縮寫英文大小寫也不敏感。

表2下面給出一些完整的Cron表示式的實(shí)例：

表2 Cron表示式示例

表示式	說明
"0 0 12 * * ? "	每天12點(diǎn)運(yùn)行
"0 15 10 ? * *"	每天10:15運(yùn)行
"0 15 10 * * ?"	每天10:15運(yùn)行
"0 15 10 * * ? *"	每天10:15運(yùn)行
"0 15 10 * * ? 2008"	在2008年的每天10：15運(yùn)行
"0 * 14 * * ?"	每天14點(diǎn)到15點(diǎn)之間每分鐘運(yùn)行一次，開始于14:00，結(jié)束于14:59。
"0 0/5 14 * * ?"	每天14點(diǎn)到15點(diǎn)每5分鐘運(yùn)行一次，開始于14:00，結(jié)束于14:55。
"0 0/5 14,18 * * ?"	每天14點(diǎn)到15點(diǎn)每5分鐘運(yùn)行一次，此外每天18點(diǎn)到19點(diǎn)每5鐘也運(yùn)行一次。
"0 0-5 14 * * ?"	每天14:00點(diǎn)到14:05，每分鐘運(yùn)行一次。
"0 10,44 14 ? 3 WED"	3月每周三的14:10分到14:44，每分鐘運(yùn)行一次。
"0 15 10 ? * MON-FRI"	每周一，二，三，四，五的10:15分運(yùn)行。
"0 15 10 15 * ?"	每月15日10:15分運(yùn)行。
"0 15 10 L * ?"	每月最后一天10:15分運(yùn)行。
"0 15 10 ? * 6L"	每月最后一個(gè)星期五10:15分運(yùn)行。
"0 15 10 ? * 6L 2007-2009"	在2007,2008,2009年每個(gè)月的最后一個(gè)星期五的10:15分運(yùn)行。
"0 15 10 ? * 6#3"	每月第三個(gè)星期五的10:15分運(yùn)行。

CronTrigger實(shí)例

下面，我們使用CronTrigger對(duì)SimpleJob進(jìn)行調(diào)度，通過Cron表達(dá)式制定調(diào)度規(guī)則，讓它每5秒鐘運(yùn)行一次：

代碼清單3 CronTriggerRunner：使用CronTrigger進(jìn)行調(diào)度

package com.baobaotao.basic.quartz;

import org.quartz.CronExpression;

import org.quartz.CronTrigger;

import org.quartz.JobDetail;

import org.quartz.Scheduler;

import org.quartz.SchedulerFactory;

import org.quartz.impl.StdSchedulerFactory;

public class CronTriggerRunner {

public static void main(String args[]) {

try {

JobDetail jobDetail = new JobDetail("job1_2", "jGroup1",SimpleJob.class);

①-1：創(chuàng)建CronTrigger，指定組及名稱

CronTrigger cronTrigger = new CronTrigger("trigger1_2", "tgroup1");

CronExpression cexp = new CronExpression("0/5 * * * * ?");①-2：定義Cron表達(dá)式

cronTrigger.setCronExpression(cexp);①-3：設(shè)置Cron表達(dá)式

SchedulerFactory schedulerFactory = new StdSchedulerFactory();

Scheduler scheduler = schedulerFactory.getScheduler();

scheduler.scheduleJob(jobDetail, cronTrigger);

scheduler.start();

//②

} catch (Exception e) {

e.printStackTrace();

}

}

}

運(yùn)行CronTriggerRunner，每5秒鐘將觸發(fā)運(yùn)行SimpleJob一次。默認(rèn)情況下Cron表達(dá)式對(duì)應(yīng)當(dāng)前的時(shí)區(qū)，可以通過CronTriggerRunner的setTimeZone(java.util.TimeZone timeZone)方法顯式指定時(shí)區(qū)。你還也可以通過setStartTime(java.util.Date startTime)和setEndTime(java.util.Date endTime)指定開始和結(jié)束的時(shí)間。

在代碼清單3的②處需要通過Thread.currentThread.sleep()的方式讓主線程睡眠，以便調(diào)度器可以繼續(xù)工作執(zhí)行任務(wù)調(diào)度。否則在調(diào)度器啟動(dòng)后，因?yàn)橹骶€程馬上退出，也將同時(shí)引起調(diào)度器關(guān)閉，調(diào)度器中的任務(wù)都將相應(yīng)銷毀，這將導(dǎo)致看不到實(shí)際的運(yùn)行效果。在單元測(cè)試的時(shí)候，讓主線程睡眠經(jīng)常使用的辦法。對(duì)于某些長(zhǎng)周期任務(wù)調(diào)度的測(cè)試，你可以簡(jiǎn)單地調(diào)整操作系統(tǒng)時(shí)間進(jìn)行模擬。

使用Calendar

在實(shí)際任務(wù)調(diào)度中，我們不可能一成不變地按照某個(gè)周期性的調(diào)度規(guī)則運(yùn)行任務(wù)，必須考慮到實(shí)現(xiàn)生活中日歷上特定日期，就象習(xí)慣了大男人作風(fēng)的人在2月14號(hào)也會(huì)有不同表現(xiàn)一樣。

下面，我們安排一個(gè)任務(wù)，每小時(shí)運(yùn)行一次，并將五一節(jié)和國際節(jié)排除在外，其代碼如代碼清單4所示：

代碼清單4 CalendarExample：使用Calendar

package com.baobaotao.basic.quartz;

import java.util.Calendar;

import java.util.Date;

import java.util.GregorianCalendar;

import org.quartz.impl.calendar.AnnualCalendar;

import org.quartz.TriggerUtils;

…

public class CalendarExample {

public static void main(String[] args) throws Exception {

SchedulerFactory sf = new StdSchedulerFactory();

Scheduler scheduler = sf.getScheduler();

①法定節(jié)日是以每年為周期的，所以使用AnnualCalendar

AnnualCalendar holidays = new AnnualCalendar();

②五一勞動(dòng)節(jié)

Calendar laborDay = new GregorianCalendar();

laborDay.add(Calendar.MONTH,5);

laborDay.add(Calendar.DATE,1);

holidays.setDayExcluded(laborDay, true); ②-1：排除的日期，如果設(shè)置為false則為包含

③國慶節(jié)

Calendar nationalDay = new GregorianCalendar();

nationalDay.add(Calendar.MONTH,10);

nationalDay.add(Calendar.DATE,1);

holidays.setDayExcluded(nationalDay, true);③-1：排除該日期

scheduler.addCalendar("holidays", holidays, false, false);④向Scheduler注冊(cè)日歷

Date runDate = TriggerUtils.getDateOf(0,0, 10, 1, 4);⑤4月1號(hào) 上午10點(diǎn)

JobDetail job = new JobDetail("job1", "group1", SimpleJob.class);

SimpleTrigger trigger = new SimpleTrigger("trigger1", "group1", 

runDate, 

null, 

SimpleTrigger.REPEAT_INDEFINITELY, 

60L * 60L * 1000L);

trigger.setCalendarName("holidays");⑥讓Trigger應(yīng)用指定的日歷規(guī)則

scheduler.scheduleJob(job, trigger);

scheduler.start();

//實(shí)際應(yīng)用中主線程不能停止，否則Scheduler得不到執(zhí)行，此處從略

}

}

由于節(jié)日是每年重復(fù)的，所以使用org.quartz.Calendar的AnnualCalendar實(shí)現(xiàn)類，通過②、③的代碼，指定五一和國慶兩個(gè)節(jié)日并通過AnnualCalendar#setDayExcluded(Calendar day, boolean exclude)方法添加這兩個(gè)日期。exclude為true時(shí)表示排除指定的日期，如果為false時(shí)表示包含指定的日期。

在定制好org.quartz.Calendar后，還需要通過Scheduler#addCalendar(String calName, Calendar calendar, boolean replace, boolean updateTriggers)進(jìn)行注冊(cè)，如果updateTriggers為true，Scheduler中已引用Calendar的Trigger將得到更新，如④所示。

在⑥處，我們讓一個(gè)Trigger指定使用Scheduler中代表節(jié)日的Calendar，這樣Trigger就會(huì)避開五一和國慶這兩個(gè)特殊日子了。

任務(wù)調(diào)度信息存儲(chǔ)

在默認(rèn)情況下Quartz將任務(wù)調(diào)度的運(yùn)行信息保存在內(nèi)存中，這種方法提供了最佳的性能，因?yàn)閮?nèi)存中數(shù)據(jù)訪問最快。不足之處是缺乏數(shù)據(jù)的持久性，當(dāng)程序路途停止或系統(tǒng)崩潰時(shí)，所有運(yùn)行的信息都會(huì)丟失。

比如我們希望安排一個(gè)執(zhí)行100次的任務(wù)，如果執(zhí)行到50次時(shí)系統(tǒng)崩潰了，系統(tǒng)重啟時(shí)任務(wù)的執(zhí)行計(jì)數(shù)器將從0開始。在大多數(shù)實(shí)際的應(yīng)用中，我們往往并不需要保存任務(wù)調(diào)度的現(xiàn)場(chǎng)數(shù)據(jù)，因?yàn)楹苌傩枰?guī)劃一個(gè)指定執(zhí)行次數(shù)的任務(wù)。

對(duì)于僅執(zhí)行一次的任務(wù)來說，其執(zhí)行條件信息本身應(yīng)該是已經(jīng)持久化的業(yè)務(wù)數(shù)據(jù)（如鎖定到期解鎖任務(wù)，解鎖的時(shí)間應(yīng)該是業(yè)務(wù)數(shù)據(jù)），當(dāng)執(zhí)行完成后，條件信息也會(huì)相應(yīng)改變。當(dāng)然調(diào)度現(xiàn)場(chǎng)信息不僅僅是記錄運(yùn)行次數(shù)，還包括調(diào)度規(guī)則、JobDataMap中的數(shù)據(jù)等等。

如果確實(shí)需要持久化任務(wù)調(diào)度信息，Quartz允許你通過調(diào)整其屬性文件，將這些信息保存到數(shù)據(jù)庫中。使用數(shù)據(jù)庫保存任務(wù)調(diào)度信息后，即使系統(tǒng)崩潰后重新啟動(dòng)，任務(wù)的調(diào)度信息將得到恢復(fù)。如前面所說的例子，執(zhí)行50次崩潰后重新運(yùn)行，計(jì)數(shù)器將從51開始計(jì)數(shù)。使用了數(shù)據(jù)庫保存信息的任務(wù)稱為持久化任務(wù)。

通過配置文件調(diào)整任務(wù)調(diào)度信息的保存策略

其實(shí)Quartz JAR文件的org.quartz包下就包含了一個(gè)quartz.properties屬性配置文件并提供了默認(rèn)設(shè)置。如果需要調(diào)整默認(rèn)配置，可以在類路徑下建立一個(gè)新的quartz.properties，它將自動(dòng)被Quartz加載并覆蓋默認(rèn)的設(shè)置。

先來了解一下Quartz的默認(rèn)屬性配置文件：

代碼清單5 quartz.properties：默認(rèn)配置

①集群的配置，這里不使用集群

org.quartz.scheduler.instanceName = DefaultQuartzScheduler

org.quartz.scheduler.rmi.export = false

org.quartz.scheduler.rmi.proxy = false

org.quartz.scheduler.wrapJobExecutionInUserTransaction = false

②配置調(diào)度器的線程池

org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPool

org.quartz.threadPool.threadCount = 10

org.quartz.threadPool.threadPriority = 5

org.quartz.threadPool.threadsInheritContextClassLoaderOfInitializingThread = true

③配置任務(wù)調(diào)度現(xiàn)場(chǎng)數(shù)據(jù)保存機(jī)制

org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore

Quartz的屬性配置文件主要包括三方面的信息：

1)集群信息；

2)調(diào)度器線程池；

3)任務(wù)調(diào)度現(xiàn)場(chǎng)數(shù)據(jù)的保存。

如果任務(wù)數(shù)目很大時(shí)，可以通過增大線程池的大小得到更好的性能。默認(rèn)情況下，Quartz采用org.quartz.simpl.RAMJobStore保存任務(wù)的現(xiàn)場(chǎng)數(shù)據(jù)，顧名思義，信息保存在RAM內(nèi)存中，我們可以通過以下設(shè)置將任務(wù)調(diào)度現(xiàn)場(chǎng)數(shù)據(jù)保存到數(shù)據(jù)庫中：

代碼清單6 quartz.properties：使用數(shù)據(jù)庫保存任務(wù)調(diào)度現(xiàn)場(chǎng)數(shù)據(jù)

…

org.quartz.jobStore.class = org.quartz.impl.jdbcjobstore.JobStoreTX

org.quartz.jobStore.tablePrefix = QRTZ_①數(shù)據(jù)表前綴

org.quartz.jobStore.dataSource = qzDS②數(shù)據(jù)源名稱

③定義數(shù)據(jù)源的具體屬性

org.quartz.dataSource.qzDS.driver = oracle.jdbc.driver.OracleDriver

org.quartz.dataSource.qzDS.URL = jdbc:oracle:thin:@localhost:1521:ora9i

org.quartz.dataSource.qzDS.user = stamen

org.quartz.dataSource.qzDS.password = abc

org.quartz.dataSource.qzDS.maxConnections = 10

要將任務(wù)調(diào)度數(shù)據(jù)保存到數(shù)據(jù)庫中，就必須使用org.quartz.impl.jdbcjobstore.JobStoreTX代替原來的org.quartz.simpl.RAMJobStore并提供相應(yīng)的數(shù)據(jù)庫配置信息。首先①處指定了Quartz數(shù)據(jù)庫表的前綴，在②處定義了一個(gè)數(shù)據(jù)源，在③處具體定義這個(gè)數(shù)據(jù)源的連接信息。

你必須事先在相應(yīng)的數(shù)據(jù)庫中創(chuàng)建Quartz的數(shù)據(jù)表（共8張），在Quartz的完整發(fā)布包的docs/dbTables目錄下?lián)碛袑?duì)應(yīng)不同數(shù)據(jù)庫的SQL腳本。

查詢數(shù)據(jù)庫中的運(yùn)行信息

任務(wù)的現(xiàn)場(chǎng)保存對(duì)于上層的Quartz程序來說是完全透明的，我們?cè)趕rc目錄下編寫一個(gè)如代碼清單6所示的quartz.properties文件后，重新運(yùn)行代碼清單2或代碼清單3的程序，在數(shù)據(jù)庫表中將可以看到對(duì)應(yīng)的持久化信息。當(dāng)調(diào)度程序運(yùn)行過程中途停止后，任務(wù)調(diào)度的現(xiàn)場(chǎng)數(shù)據(jù)將記錄在數(shù)據(jù)表中，在系統(tǒng)重啟時(shí)就可以在此基礎(chǔ)上繼續(xù)進(jìn)行任務(wù)的調(diào)度。

代碼清單7 JDBCJobStoreRunner：從數(shù)據(jù)庫中恢復(fù)任務(wù)的調(diào)度

package com.baobaotao.basic.quartz;

import org.quartz.Scheduler;

import org.quartz.SchedulerFactory;

import org.quartz.SimpleTrigger;

import org.quartz.Trigger;

import org.quartz.impl.StdSchedulerFactory;

public class JDBCJobStoreRunner {

public static void main(String args[]) {

try {

SchedulerFactory schedulerFactory = new StdSchedulerFactory();

Scheduler scheduler = schedulerFactory.getScheduler();

①獲取調(diào)度器中所有的觸發(fā)器組

String[] triggerGroups = scheduler.getTriggerGroupNames();

②重新恢復(fù)在tgroup1組中，名為trigger1_1觸發(fā)器的運(yùn)行

for (int i = 0; i < triggerGroups.length; i++) {

String[] triggers = scheduler.getTriggerNames(triggerGroups[i]);

for (int j = 0; j < triggers.length; j++) {

Trigger tg = scheduler.getTrigger(triggers[j],triggerGroups[i]);

if (tg instanceof SimpleTrigger

&& tg.getFullName().equals("tgroup1.trigger1_1")) {②-1:根據(jù)名稱判斷

②-1:恢復(fù)運(yùn)行

scheduler.rescheduleJob(triggers[j], triggerGroups[i],tg);

}

}

}

scheduler.start();

} catch (Exception e) {

e.printStackTrace();

}

}

}

當(dāng)代碼清單2中的SimpleTriggerRunner執(zhí)行到一段時(shí)間后非正常退出，我們就可以通過這個(gè)JDBCJobStoreRunner根據(jù)記錄在數(shù)據(jù)庫中的現(xiàn)場(chǎng)數(shù)據(jù)恢復(fù)任務(wù)的調(diào)度。Scheduler中的所有Trigger以及JobDetail的運(yùn)行信息都會(huì)保存在數(shù)據(jù)庫中，這里我們僅恢復(fù)tgroup1組中名稱為trigger1_1的觸發(fā)器，這可以通過如②-1所示的代碼進(jìn)行過濾，觸發(fā)器的采用GROUP.TRIGGER_NAME的全名格式。通過Scheduler#rescheduleJob(String triggerName,String groupName,Trigger newTrigger)即可重新調(diào)度關(guān)聯(lián)某個(gè)Trigger的任務(wù)。

下面我們來觀察一下不同時(shí)期qrtz_simple_triggers表的數(shù)據(jù)：

1．運(yùn)行代碼清單2的SimpleTriggerRunner一小段時(shí)間后退出：

500){this.resized=true;this.style.width=500;}" align=center resized="true">

REPEAT_COUNT表示需要運(yùn)行的總次數(shù)，而TIMES_TRIGGER表示已經(jīng)運(yùn)行的次數(shù)。

2．運(yùn)行代碼清單7的JDBCJobStoreRunner恢復(fù)trigger1_1的觸發(fā)器，運(yùn)行一段時(shí)間后退出，這時(shí)qrtz_simple_triggers中的數(shù)據(jù)如下：

500){this.resized=true;this.style.width=500;}" align=center resized="true">

首先Quartz會(huì)將原REPEAT_COUNT-TIMES_TRIGGER得到新的REPEAT_COUNT值，并記錄已經(jīng)運(yùn)行的次數(shù)（重新從0開始計(jì)算）。

3．重新啟動(dòng)JDBCJobStoreRunner運(yùn)行后，數(shù)據(jù)又將發(fā)生相應(yīng)的變化：

500){this.resized=true;this.style.width=500;}" align=center resized="true">

4．繼續(xù)運(yùn)行直至完成所有剩余的次數(shù)，再次查詢qrtz_simple_triggers表：

500){this.resized=true;this.style.width=500;}" align=center resized="true">

這時(shí)，該表中的記錄已經(jīng)變空。

值得注意的是，如果你使用JDBC保存任務(wù)調(diào)度數(shù)據(jù)時(shí)，當(dāng)你運(yùn)行代碼清單2的SimpleTriggerRunner然后退出，當(dāng)再次希望運(yùn)行SimpleTriggerRunner時(shí)，系統(tǒng)將拋出JobDetail重名的異常：

Unable to store Job with name: 'job1_1' and group: 'jGroup1', because one already exists with this identification.

因?yàn)槊看握{(diào)用Scheduler#scheduleJob()時(shí)，Quartz都會(huì)將JobDetail和Trigger的信息保存到數(shù)據(jù)庫中，如果數(shù)據(jù)表中已經(jīng)同名的JobDetail或Trigger，異常就產(chǎn)生了。

本文使用quartz 1.6版本，我們發(fā)現(xiàn)當(dāng)后臺(tái)數(shù)據(jù)庫使用MySql時(shí)，數(shù)據(jù)保存不成功，該錯(cuò)誤是Quartz的一個(gè)Bug，相信會(huì)在高版本中得到修復(fù)。因?yàn)镠SQLDB不支持SELECT * FROM TABLE_NAME FOR UPDATE的語法，所以不能使用HSQLDB數(shù)據(jù)庫。

小結(jié)

Quartz提供了最為豐富的任務(wù)調(diào)度功能，不但可以制定周期性運(yùn)行的任務(wù)調(diào)度方案，還可以讓你按照日歷相關(guān)的方式進(jìn)行任務(wù)調(diào)度。Quartz框架的重要組件包括Job、JobDetail、Trigger、Scheduler以及輔助性的JobDataMap和SchedulerContext。

Quartz擁有一個(gè)線程池，通過線程池為任務(wù)提供執(zhí)行線程，你可以通過配置文件對(duì)線程池進(jìn)行參數(shù)定制。Quartz的另一個(gè)重要功能是可將任務(wù)調(diào)度信息持久化到數(shù)據(jù)庫中，以便系統(tǒng)重啟時(shí)能夠恢復(fù)已經(jīng)安排的任務(wù)。此外，Quartz還擁有完善的事件體系，允許你注冊(cè)各種事件的監(jiān)聽器。