gbk

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

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

●Job：是一個(gè)接口，只有一個(gè)方法void execute(JobExecutionContext context)，開(kāi)發(fā)者實(shí)現(xiàn)該接口定義運(yùn)行任務(wù)，JobExecutionContext類(lèi)提供了調(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)類(lèi)，以便運(yùn)行時(shí)通過(guò)newInstance()的反射機(jī)制實(shí)例化Job。因此需要通過(guò)一個(gè)類(lèi)來(lái)描述 Job的實(shí)現(xiàn)類(lèi)及其它相關(guān)的靜態(tài)信息，如Job名字、描述、關(guān)聯(lián)監(jiān)聽(tīng)器等信息，JobDetail承擔(dān)了這一角色。

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

●Trigger：是一個(gè)類(lèi)，描述觸發(fā)Job執(zhí)行的時(shí)間觸發(fā)規(guī)則。主要有 SimpleTrigger和CronTrigger這兩個(gè)子類(lèi)。當(dāng)僅需觸發(fā)一次或者以固定時(shí)間間隔周期執(zhí)行，SimpleTrigger是最適合的選 擇；而CronTrigger則可以通過(guò)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)，無(wú)特殊說(shuō)明后面的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í)間段類(lèi)型，Quartz在 org.quartz.impl.calendar包下提供了若干個(gè)Calendar的實(shí)現(xiàn)類(lèi)，如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)樗鼈兪遣煌?lèi)型 的）。Scheduler定義了多個(gè)接口方法，允許外部通過(guò)組及名稱訪問(wèn)和控制容器中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。可以通過(guò) SchedulerFactory創(chuàng)建一個(gè)Scheduler實(shí)例。Scheduler擁有一個(gè)SchedulerContext，它類(lèi)似于 ServletContext，保存著Scheduler上下文信息，Job和Trigger都可以訪問(wèn)SchedulerContext內(nèi)的信息。 SchedulerContext內(nèi)部通過(guò)一個(gè)Map，以鍵值對(duì)的方式維護(hù)這些上下文數(shù)據(jù)，SchedulerContext為保存和獲取數(shù)據(jù)提供了多個(gè) put()和getXxx()的方法。可以通過(guò)Scheduler# getContext()獲取對(duì)應(yīng)的SchedulerContext實(shí)例；

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

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

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

如果Quartz使用了數(shù)據(jù)庫(kù)持久化任務(wù)調(diào)度信息，無(wú)狀態(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可以通過(guò) JobExecutionContext#getTrigger().getJobDataMap()獲取Trigger中的JobDataMap。不管 是有狀態(tài)還是無(wú)狀態(tài)的任務(wù)，在任務(wù)執(zhí)行期間對(duì)Trigger的JobDataMap所做的更改都不會(huì)進(jìn)行持久，也即不會(huì)對(duì)下次的執(zhí)行產(chǎn)生影響。

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

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

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

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

Scheduler本身就是一個(gè)容器，它維護(hù)著Quartz的各種組件并實(shí)施調(diào)度的規(guī)則。 Scheduler還擁有一個(gè)線程池，線程池為任務(wù)提供執(zhí)行線程——這比執(zhí)行任務(wù)時(shí)簡(jiǎn)單地創(chuàng)建一個(gè)新線程要擁有更高的效率，同時(shí)通過(guò)共享節(jié)約資源的占用。 通過(guò)線程池組件的支持，對(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)：通過(guò)該構(gòu)造函數(shù)指定Trigger所屬組和名稱；

●SimpleTrigger(String name, String group, Date startTime)：除指定Trigger所屬組和名稱外，還可以指定觸發(fā)的開(kāi)發(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í)，還通過(guò)jobGroup和jobName，讓該Trigger和 Scheduler中的某個(gè)任務(wù)關(guān)聯(lián)起來(lái)。

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

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

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è)類(lèi)用一條非常簡(jiǎn)單的輸出語(yǔ)句實(shí)現(xiàn)了Job接口的execute(JobExecutionContext context) 方法，這個(gè)方法可以包含想要執(zhí)行的任何代碼。下面，我們通過(guò)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);

②通過(guò)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);

③通過(guò)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();

}

}

}

首先在①處通過(guò)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中。這里，我們通過(guò)StdSchedulerFactory獲取一個(gè)Scheduler實(shí)例，并通過(guò)scheduleJob (JobDetail jobDetail, Trigger trigger)完成兩件事：

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

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

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

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

除了通過(guò)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通過(guò)指定Job所屬組及Job名稱，然后使用Scheduler的scheduleJob(Trigger trigger)方法注冊(cè)Trigger。有兩個(gè)值得注意的地方：

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

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

在構(gòu)造Trigger實(shí)例時(shí)，可以考慮使用org.quartz.TriggerUtils 工具類(lèi)，該工具類(lèi)不但提供了眾多獲取特定時(shí)間的方法，還擁有眾多獲取常見(jiàn)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使用類(lèi)似于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ì)說(shuō)如下：●星號(hào)(*)：可用在所有字段中，表示對(duì)應(yīng)時(shí)間域的每一個(gè)時(shí) 刻，例如，*在分鐘字段時(shí)，表示“每分鐘”；●問(wèn)號(hào)（?）：該字符只在日期和星期字段中使用，它通常指定為“無(wú)意義的值”，相當(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)月沒(méi)有第五個(gè)星期三，忽略不觸發(fā)；● C：該字符只在日期和星期字段中使用，代表“Calendar”的意思。它的意思是計(jì)劃所關(guān)聯(lián)的日期，如果日期沒(méi)有被關(guān)聯(lián)，則相當(dāng)于日歷中所有日期。例如 5C在日期字段中就相當(dāng)于日歷5日以后的第一天。1C在星期字段中相當(dāng)于星期日后的第一天。Cron表達(dá)式對(duì)特殊字符的大小寫(xiě)不敏感，對(duì)代表星期的縮寫(xiě)英 文大小寫(xiě)也不敏感。表2下面給出一些完整的Cron表示式的實(shí)例：表2 Cron表示式示例

表示式	說(shuō)明
"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)行一次，開(kāi)始于14:00，結(jié)束于14:59。
"0 0/5 14 * * ?"	每天14點(diǎn)到15點(diǎn)每5分鐘運(yùn)行一次，開(kāi)始于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)度，通過(guò)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ū)，可以通過(guò)CronTriggerRunner的setTimeZone(java.util.TimeZone timeZone)方法顯式指定時(shí)區(qū)。你還也可以通過(guò)setStartTime(java.util.Date startTime)和setEndTime(java.util.Date endTime)指定開(kāi)始和結(jié)束的時(shí)間。

在代碼清單3的②處需要通過(guò)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)銷(xiāo)毀， 這將導(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é)和國(guó)際節(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則為包含

③國(guó)慶節(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)類(lèi)，通過(guò)②、③的代碼，指定五一和國(guó)慶兩個(gè)節(jié)日并通過(guò)AnnualCalendar#setDayExcluded (Calendar day, boolean exclude)方法添加這兩個(gè)日期。exclude為true時(shí)表示排除指定的日期，如果為false時(shí)表示包含指定的日期。

在定制好org.quartz.Calendar后，還需要通過(guò) 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ì)避開(kāi)五一和國(guó)慶這兩個(gè)特殊日子了。

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

在默認(rèn)情況下Quartz將任務(wù)調(diào)度的運(yùn)行信息保存在內(nèi)存中，這種方法提供了最佳的性能，因?yàn)閮?nèi)存中數(shù)據(jù)訪問(wèn)最快。不足之處是缺乏數(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開(kāi)始。在大多數(shù)實(shí)際的應(yīng)用中，我們往往并不需要保存任務(wù)調(diào)度的現(xiàn)場(chǎng)數(shù)據(jù)，因?yàn)楹苌傩枰?guī)劃一個(gè)指定執(zhí)行次數(shù)的任務(wù)。

對(duì)于僅執(zhí)行一次的任務(wù)來(lái)說(shuō)，其執(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允許你通過(guò)調(diào)整其屬性文件，將這些信息保存到 數(shù)據(jù)庫(kù)中。使用數(shù)據(jù)庫(kù)保存任務(wù)調(diào)度信息后，即使系統(tǒng)崩潰后重新啟動(dòng)，任務(wù)的調(diào)度信息將得到恢復(fù)。如前面所說(shuō)的例子，執(zhí)行50次崩潰后重新運(yùn)行，計(jì)數(shù)器將從 51開(kāi)始計(jì)數(shù)。使用了數(shù)據(jù)庫(kù)保存信息的任務(wù)稱為持久化任務(wù)。

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

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

先來(lái)了解一下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í)，可以通過(guò)增大線程池的大小得到更好的性能。默認(rèn)情況下，Quartz采用org.quartz.simpl.RAMJobStore保存任務(wù)的現(xiàn)場(chǎng)數(shù)據(jù)，顧名思義，信息保存在RAM內(nèi)存中，我們可以通過(guò)以下設(shè)置將任務(wù)調(diào)度現(xiàn)場(chǎng)數(shù)據(jù)保存到數(shù)據(jù)庫(kù)中：

代碼清單6 quartz.properties：使用數(shù)據(jù)庫(kù)保存任務(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ù)庫(kù)中，就必須使用 org.quartz.impl.jdbcjobstore.JobStoreTX代替原來(lái)的org.quartz.simpl.RAMJobStore 并提供相應(yīng)的數(shù)據(jù)庫(kù)配置信息。首先①處指定了Quartz數(shù)據(jù)庫(kù)表的前綴，在②處定義了一個(gè)數(shù)據(jù)源，在③處具體定義這個(gè)數(shù)據(jù)源的連接信息。

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

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

任務(wù)的現(xiàn)場(chǎng)保存對(duì)于上層的Quartz程序來(lái)說(shuō)是完全透明的，我們?cè)趕rc目錄下編寫(xiě)一個(gè)如 代碼清單6所示的quartz.properties文件后，重新運(yùn)行代碼清單2或代碼清單3的程序，在數(shù)據(jù)庫(kù)表中將可以看到對(duì)應(yīng)的持久化信息。當(dāng)調(diào)度程 序運(yùn)行過(guò)程中途停止后，任務(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ù)庫(kù)中恢復(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í)間后非正常退出，我們 就可以通過(guò)這個(gè)JDBCJobStoreRunner根據(jù)記錄在數(shù)據(jù)庫(kù)中的現(xiàn)場(chǎng)數(shù)據(jù)恢復(fù)任務(wù)的調(diào)度。Scheduler中的所有Trigger以及 JobDetail的運(yùn)行信息都會(huì)保存在數(shù)據(jù)庫(kù)中，這里我們僅恢復(fù)tgroup1組中名稱為trigger1_1的觸發(fā)器，這可以通過(guò)如②-1所示的代碼 進(jìn)行過(guò)濾，觸發(fā)器的采用GROUP.TRIGGER_NAME的全名格式。通過(guò)Scheduler#rescheduleJob(String triggerName,String groupName,Trigger newTrigger)即可重新調(diào)度關(guān)聯(lián)某個(gè)Trigger的任務(wù)。

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

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

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ù)如下：

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

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

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

這時(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ù)庫(kù)中，如果數(shù)據(jù)表中已經(jīng)同名的JobDetail或Trigger，異常就產(chǎn)生了。

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

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

Quartz是一個(gè)開(kāi)源的作業(yè)調(diào)度框架，它完全由java寫(xiě)成，并設(shè)計(jì)用于J2SE和 J2EE應(yīng)用中。它提供了巨大的靈活性而不犧牲簡(jiǎn)單性。你能夠用它來(lái)為執(zhí)行一個(gè)作業(yè)而創(chuàng)建簡(jiǎn)單的或復(fù)雜的調(diào)度。它有很多特征，如：數(shù)據(jù)庫(kù)支持，集群，插 件，EJB作業(yè)預(yù)構(gòu)建，JavaMail及其它，支持cron-like表達(dá)式等等。

本文內(nèi)容

1．        Quartz讓任務(wù)調(diào)度簡(jiǎn)單

2．        Quartz的發(fā)展史

3．        上手Quartz

4．        Quartz內(nèi)部架構(gòu)

5．        作業(yè)

6．        作業(yè)管理和存儲(chǔ)

7．        有效作業(yè)存儲(chǔ)

8．        作業(yè)和觸發(fā)器

9．        調(diào)度一個(gè)作業(yè)

10．        用調(diào)度器（Scheduler）調(diào)用你的作業(yè)

11．        編程調(diào)度同聲明性調(diào)度

12．        有狀態(tài)和無(wú)狀態(tài)作業(yè)

13．        Quartz框架的其他特征

14．        Quartz下一步計(jì)劃

15．        了解更多Quartz特征

你曾經(jīng)需要應(yīng)用執(zhí)行一個(gè)任務(wù)嗎？這個(gè)任務(wù)每天或每周星期二晚上11：30，或許僅僅每個(gè)月的 最后一天執(zhí)行。一個(gè)自動(dòng)執(zhí)行而無(wú)須干預(yù)的任務(wù)在執(zhí)行過(guò)程中如果發(fā)生一個(gè)嚴(yán)重錯(cuò)誤，應(yīng)用能夠知到其執(zhí)行失敗并嘗試重新執(zhí)行嗎？你和你的團(tuán)隊(duì)是用java編程 嗎？如果這些問(wèn)題中任何一個(gè)你回答是，那么你應(yīng)該使用Quartz調(diào)度器。

旁注：Matrix目前就大量使用到了Quartz。比如，排名統(tǒng)計(jì)功能的實(shí)現(xiàn)，在Jmatrix里通過(guò)Quartz定義了一個(gè)定時(shí)調(diào)度作業(yè)，在每天凌晨一點(diǎn)，作業(yè)開(kāi)始工作，重新統(tǒng)計(jì)大家的Karma和排名等。

還有，RSS文件的生成，也是通過(guò)Quartz定義作業(yè)，每隔半個(gè)小時(shí)生成一次RSS XML文件。

所以Quartz使用的地方很多，本文無(wú)疑是一篇很好的入門(mén)和進(jìn)階的文章，在此，感謝David w Johnson的努力！

Quartz讓作業(yè)調(diào)度簡(jiǎn)單

Quartz是一個(gè)完全由java編寫(xiě)的開(kāi)源作業(yè)調(diào)度框架。不要讓作業(yè)調(diào)度這個(gè)術(shù)語(yǔ)嚇著你。 盡管Quartz框架整合了許多額外功能， 但就其簡(jiǎn)易形式看，你會(huì)發(fā)現(xiàn)它易用得簡(jiǎn)直讓人受不了！。簡(jiǎn)單地創(chuàng)建一個(gè)實(shí)現(xiàn)org.quartz.Job接口的java類(lèi)。Job接口包含唯一的方法：

public void execute(JobExecutionContext context)

     throws JobExecutionException;

在你的Job接口實(shí)現(xiàn)類(lèi)里面，添加一些邏輯到execute()方法。一旦你配置好Job實(shí) 現(xiàn)類(lèi)并設(shè)定好調(diào)度時(shí)間表，Quartz將密切注意剩余時(shí)間。當(dāng)調(diào)度程序確定該是通知你的作業(yè)的時(shí)候，Quartz框架將調(diào)用你Job實(shí)現(xiàn)類(lèi)（作業(yè)類(lèi)）上的 execute()方法并允許做它該做的事情。無(wú)需報(bào)告任何東西給調(diào)度器或調(diào)用任何特定的東西。僅僅執(zhí)行任務(wù)和結(jié)束任務(wù)即可。如果配置你的作業(yè)在隨后再次 被調(diào)用，Quartz框架將在恰當(dāng)?shù)臅r(shí)間再次調(diào)用它。

如果你使用了其它流行的開(kāi)源框架象struts，你會(huì)對(duì)Quartz的設(shè)計(jì)和部件感到舒適。 雖然兩個(gè)開(kāi)源工程是解決完全不同的問(wèn)題，還是有很多相似的之處，就是開(kāi)源軟件用戶每天感覺(jué)很舒適。Quartz能用在單機(jī)J2SE應(yīng)用中，作為一個(gè)RMI 服務(wù)器，也可以用在web應(yīng)用中，甚至也可以用在J2EE應(yīng)用服務(wù)器中。

Quartz的發(fā)展史

盡管Quartz今年開(kāi)始受到人們注意，但還是暫時(shí)流行。Quartz由James House創(chuàng)建并最初于2001年春天被加入sourceforge工程。接下來(lái)的幾年里，有許多新特征和版本出現(xiàn)，但是直到項(xiàng)目遷移到新的站點(diǎn)并成為 OpenSymphony項(xiàng)目家族的一員，才開(kāi)始真正啟動(dòng)并受到應(yīng)有的關(guān)注。

James House仍然和幾個(gè)協(xié)助他的業(yè)余開(kāi)發(fā)者參與大量開(kāi)發(fā)工作。Quartz開(kāi)發(fā)團(tuán)隊(duì)今年能發(fā)布幾個(gè)新版本，包括當(dāng)前正處在候選發(fā)布階段的1.5版。

上手Quartz

Quartz工程駐留在OpenSymphony站點(diǎn)上。在Quartz站點(diǎn)上可以找到許多有用的資源：JavaDocs，包含指南的文檔，CVS訪問(wèn)，用戶和開(kāi)發(fā)者論壇的連接，當(dāng)然也有下載。

從下載連接取得Quartz的發(fā)布版本，并且解壓到到本地目錄。這個(gè)下載文件包含了一個(gè)預(yù)先 構(gòu)建好的Quartz二進(jìn)制文件（quartz.jar），你可以將它放進(jìn)自己的應(yīng)用中。Quartz框架只需要少數(shù)的第三方庫(kù)，并且這些三方庫(kù)是必需 的，你很可能已經(jīng)在使用這些庫(kù)了。

你要把Quartz的安裝目錄的<quartz- install>/lib/core 和 <quartz-install>/lib/optional目錄中的第三方庫(kù)加進(jìn)你自己的工程中。大多數(shù)第三方庫(kù)是我們所熟知和喜歡的標(biāo)準(zhǔn) Jakarta Commons庫(kù)，像Commons Logging, Commons BeantUtils等等。

quartz.properties文件

Quartz有一個(gè)叫做quartz.properties的配置文件，它允許你修改框架運(yùn) 行時(shí)環(huán)境。缺省是使用Quartz.jar里面的quartz.properties文件。當(dāng)然，你應(yīng)該創(chuàng)建一個(gè)quartz.properties文件 的副本并且把它放入你工程的classes目錄中以便類(lèi)裝載器找到它。quartz.properties樣本文件如例1所示。

例1.quartz.properties文件允許修改Quartz運(yùn)行環(huán)境：

#===============================================================

# Configure Main Scheduler Properties  

#===============================================================

org.quartz.scheduler.instanceName = QuartzScheduler

org.quartz.scheduler.instanceId = AUTO

#===============================================================

# Configure ThreadPool  

#===============================================================

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

org.quartz.threadPool.threadCount =  5

org.quartz.threadPool.threadPriority = 5

#===============================================================

# Configure JobStore  

#===============================================================

org.quartz.jobStore.misfireThreshold = 60000

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

一旦將Quartz.jar文件和第三方庫(kù)加到自己的工程里面并且quartz.properties文件在工程的classes目錄中，就可以創(chuàng)建作業(yè)了。然而，在做這之前，我們暫且回避一下先簡(jiǎn)短討論一下Quartz架構(gòu)。

Quartz內(nèi)部架構(gòu)

在規(guī)模方面，Quartz跟大多數(shù)開(kāi)源框架類(lèi)似。大約有300個(gè)java類(lèi)和接口，并被組織 到12個(gè)包中。這可以和Apache Struts把大約325個(gè)類(lèi)和接口以及組織到11個(gè)包中相比。盡管規(guī)模幾乎不會(huì)用來(lái)作為衡量框架質(zhì)量的一個(gè)特性，但這里的關(guān)鍵是quarts內(nèi)含很多功 能，這些功能和特性集是否成為、或者應(yīng)該成為評(píng)判一個(gè)開(kāi)源或非開(kāi)源框架質(zhì)量的因素。

Quartz調(diào)度器

Quartz框架的核心是調(diào)度器。調(diào)度器負(fù)責(zé)管理Quartz應(yīng)用運(yùn)行時(shí)環(huán)境。調(diào)度器不是靠 自己做所有的工作，而是依賴框架內(nèi)一些非常重要的部件。Quartz不僅僅是線程和線程管理。為確保可伸縮性，Quartz采用了基于多線程的架構(gòu)。啟動(dòng) 時(shí)，框架初始化一套worker線程，這套線程被調(diào)度器用來(lái)執(zhí)行預(yù)定的作業(yè)。這就是Quartz怎樣能并發(fā)運(yùn)行多個(gè)作業(yè)的原理。Quartz依賴一套松耦 合的線程池管理部件來(lái)管理線程環(huán)境。本片文障中，我們會(huì)多次提到線程池管理，但Quartz里面的每個(gè)對(duì)象是可配置的或者是可定制的。所以，例如，如果你 想要插進(jìn)自己線程池管理設(shè)施，我猜你一定能！

作業(yè)

用Quartz的行話講，作業(yè)是一個(gè)執(zhí)行任務(wù)的簡(jiǎn)單java類(lèi)。任務(wù)可以是任何java代 碼。只需你實(shí)現(xiàn)org.quartz.Job接口并且在出現(xiàn)嚴(yán)重錯(cuò)誤情況下拋出JobExecutionException異常即可。Job接口包含唯一 的一個(gè)方法execute()，作業(yè)從這里開(kāi)始執(zhí)行。一旦實(shí)現(xiàn)了Job接口和execute()方法，當(dāng)Quartz確定該是作業(yè)運(yùn)行的時(shí)候，它將調(diào)用你 的作業(yè)。Execute()方法內(nèi)就完全是你要做的事情。下面有一些你要在作業(yè)里面做事情的例子：

·        用JavaMail（或者用其他的像Commons Net一樣的郵件框架）發(fā)送郵件

·        創(chuàng)建遠(yuǎn)程接口并且調(diào)用在EJB上的方法

·        獲取Hibernate Session，查詢和更新關(guān)系數(shù)據(jù)庫(kù)里的數(shù)據(jù)

·        使用OSWorkflow并且從作業(yè)調(diào)用一個(gè)工作流

·        使用FTP和到處移動(dòng)文件

·        調(diào)用Ant構(gòu)建腳本開(kāi)始預(yù)定構(gòu)建

這種可能性是無(wú)窮的，正事這種無(wú)限可能性使得框架功能如此強(qiáng)大。Quartz給你提供了一個(gè)機(jī)制來(lái)建立具有不同粒度的、可重復(fù)的調(diào)度表，于是，你只需創(chuàng)建一個(gè)java類(lèi)，這個(gè)類(lèi)被調(diào)用而執(zhí)行任務(wù)。

作業(yè)管理和存儲(chǔ)

作業(yè)一旦被調(diào)度，調(diào)度器需要記住并且跟蹤作業(yè)和它們的執(zhí)行次數(shù)。如果你的作業(yè)是30分鐘后或 每30秒調(diào)用，這不是很有用。事實(shí)上，作業(yè)執(zhí)行需要非常準(zhǔn)確和即時(shí)調(diào)用在被調(diào)度作業(yè)上的execute()方法。Quartz通過(guò)一個(gè)稱之為作業(yè)存儲(chǔ) （JobStore）的概念來(lái)做作業(yè)存儲(chǔ)和管理。

有效作業(yè)存儲(chǔ)

Quartz提供兩種基本作業(yè)存儲(chǔ)類(lèi)型。第一種類(lèi)型叫做RAMJobStore，它利用通常 的內(nèi)存來(lái)持久化調(diào)度程序信息。這種作業(yè)存儲(chǔ)類(lèi)型最容易配置、構(gòu)造和運(yùn)行。對(duì)許多應(yīng)用來(lái)說(shuō)，這種作業(yè)存儲(chǔ)已經(jīng)足夠了。然而，因?yàn)檎{(diào)度程序信息是存儲(chǔ)在被分配 給JVM的內(nèi)存里面，所以，當(dāng)應(yīng)用程序停止運(yùn)行時(shí)，所有調(diào)度信息將被丟失。如果你需要在重新啟動(dòng)之間持久化調(diào)度信息，則將需要第二種類(lèi)型的作業(yè)存儲(chǔ)。

第二種類(lèi)型的作業(yè)存儲(chǔ)實(shí)際上提供兩種不同的實(shí)現(xiàn)，但兩種實(shí)現(xiàn)一般都稱為JDBC作業(yè)存儲(chǔ)。兩 種JDBC作業(yè)存儲(chǔ)都需要JDBC驅(qū)動(dòng)程序和后臺(tái)數(shù)據(jù)庫(kù)來(lái)持久化調(diào)度程序信息。這兩種類(lèi)型的不同在于你是否想要控制數(shù)據(jù)庫(kù)事務(wù)或這釋放控制給應(yīng)用服務(wù)器例 如BEA's WebLogic或Jboss。（這類(lèi)似于J2EE領(lǐng)域中，Bean管理的事務(wù)和和容器管理事務(wù)之間的區(qū)別）

這兩種JDBC作業(yè)存儲(chǔ)是：

·        JobStoreTX：當(dāng)你想要控制事務(wù)或工作在非應(yīng)用服務(wù)器環(huán)境中是使用

·        JobStoreCMT：當(dāng)你工作在應(yīng)用服務(wù)器環(huán)境中和想要容器控制事務(wù)時(shí)使用。

JDBC作業(yè)存儲(chǔ)為需要調(diào)度程序維護(hù)調(diào)度信息的用戶而設(shè)計(jì)。

作業(yè)和觸發(fā)器

Quartz設(shè)計(jì)者做了一個(gè)設(shè)計(jì)選擇來(lái)從調(diào)度分離開(kāi)作業(yè)。Quartz中的觸發(fā)器用來(lái)告訴調(diào) 度程序作業(yè)什么時(shí)候觸發(fā)。框架提供了一把觸發(fā)器類(lèi)型，但兩個(gè)最常用的是SimpleTrigger和CronTrigger。SimpleTrigger 為需要簡(jiǎn)單打火調(diào)度而設(shè)計(jì)。典型地，如果你需要在給定的時(shí)間和重復(fù)次數(shù)或者兩次打火之間等待的秒數(shù)打火一個(gè)作業(yè)，那么SimpleTrigger適合你。 另一方面，如果你有許多復(fù)雜的作業(yè)調(diào)度，那么或許需要CronTrigger。

CronTrigger是基于Calendar-like調(diào)度的。當(dāng)你需要在除星期六和星期天外的每天上午10點(diǎn)半執(zhí)行作業(yè)時(shí)，那么應(yīng)該使用CronTrigger。正如它的名字所暗示的那樣，CronTrigger是基于Unix克隆表達(dá)式的。

作為一個(gè)例子，下面的Quartz克隆表達(dá)式將在星期一到星期五的每天上午10點(diǎn)15分執(zhí)行一個(gè)作業(yè)。

0 15 10 ? * MON-FRI

下面的表達(dá)式

0 15 10 ? * 6L 2002-2005

將在2002年到2005年的每個(gè)月的最后一個(gè)星期五上午10點(diǎn)15分執(zhí)行作業(yè)。

你不可能用SimpleTrigger來(lái)做這些事情。你可以用兩者之中的任何一個(gè)，但哪個(gè)跟合適則取決于你的調(diào)度需要。

調(diào)度一個(gè)作業(yè)

讓我們通過(guò)看一個(gè)例子來(lái)進(jìn)入實(shí)際討論。現(xiàn)假定你管理一個(gè)部門(mén)，無(wú)論何時(shí)候客戶在它的FTP服 務(wù)器上存儲(chǔ)一個(gè)文件，都得用電子郵件通知它。我們的作業(yè)將用FTP登陸到遠(yuǎn)程服務(wù)器并下載所有找到的文件。然后，它將發(fā)送一封含有找到和下載的文件數(shù)量的 電子郵件。這個(gè)作業(yè)很容易就幫助人們整天從手工執(zhí)行這個(gè)任務(wù)中解脫出來(lái)，甚至連晚上都無(wú)須考慮。我們可以設(shè)置作業(yè)循環(huán)不斷地每60秒檢查一次，而且工作在 7×24模式下。這就是Quartz框架完全的用途。

首先創(chuàng)建一個(gè)Job類(lèi)，將執(zhí)行FTP和Email邏輯。下例展示了Quartz的Job類(lèi)，它實(shí)現(xiàn)了org.quartz.Job接口。

例2．從FTP站點(diǎn)下載文件和發(fā)送email的Quartz作業(yè)

public class ScanFTPSiteJob implements Job {

    private static Log logger = LogFactory.getLog(ScanFTPSiteJob.class);

    /*

     * Called the scheduler framework at the right time

     */

    public void execute(JobExecutionContext context)

            throws JobExecutionException {

        JobDataMap jobDataMap = context.getJobDataMap();

        try {

            // Check the ftp site for files

            File[] files = JobUtil.checkForFiles(jobDataMap);

            JobUtil.sendEmail(jobDataMap, files);

        } catch (Exception ex) {

            throw new JobExecutionException(ex.getMessage());

        }

    }

}

我們故意讓ScanFTPSiteJob保持很簡(jiǎn)單。我們?yōu)檫@個(gè)例子創(chuàng)建了一個(gè)叫做 JobUtil的實(shí)用類(lèi)。它不是Quartz的組成部分，但對(duì)構(gòu)建各種作業(yè)能重用的實(shí)用程序庫(kù)來(lái)說(shuō)是有意義的。我們可以輕易將那種代碼組織進(jìn)作業(yè)類(lèi)中， quarts 調(diào)度器一樣好用，因?yàn)槲覀円恢痹谑褂胵uarts，所以那些代碼可繼續(xù)重用。

JobUtil.checkForFiles() and JobUtil.sendEmail()方法使用的參數(shù)是Quartz創(chuàng)建的JobDataMap的實(shí)例。實(shí)例為每個(gè)作業(yè)的執(zhí)行而創(chuàng)建，它是向作業(yè)類(lèi)傳遞配置參數(shù)的方法。

這里并沒(méi)有展示JobUtil的實(shí)現(xiàn)，但我們能用Jakarta上的Commons Net輕易地實(shí)現(xiàn)FTP和Email功能。

用調(diào)度器調(diào)用作業(yè)

首先創(chuàng)建一個(gè)作業(yè)，但為使作業(yè)能被調(diào)度器調(diào)用，你得向調(diào)度程序說(shuō)明你的作業(yè)的調(diào)用時(shí)間和頻率。這個(gè)事情由與作業(yè)相關(guān)的觸發(fā)器來(lái)完成。因?yàn)槲覀儍H僅對(duì)大約每60秒循環(huán)調(diào)用作業(yè)感興趣，所以打算使用SimpleTrigger。

作業(yè)和觸發(fā)器通過(guò)Quartz調(diào)度器接口而被調(diào)度。我們需要從調(diào)度器工廠類(lèi)取得一個(gè)調(diào)度器的實(shí)例。最容易的辦法是調(diào)用StdSchedulerFactory這個(gè)類(lèi)上的靜態(tài)方法getDefaultScheduler()。

使用Quartz框架，你需要調(diào)用start()方法來(lái)啟動(dòng)調(diào)度器。例3的代碼遵循了大多數(shù)Quartz應(yīng)用的一般模式：創(chuàng)建一個(gè)或多個(gè)作業(yè)，創(chuàng)建和設(shè)置觸發(fā)器，用調(diào)度器調(diào)度作業(yè)和觸發(fā)器，啟動(dòng)調(diào)度器。

例3．Quartz作業(yè)通過(guò)Quartz調(diào)度器而被調(diào)度

public class MyQuartzServer {

    public static void main(String[] args) {

        MyQuartzServer server = new MyQuartzServer();

        try {

            server.startScheduler();

        } catch (SchedulerException ex) {

            ex.printStackTrace();

        }

    }

    protected void startScheduler() throws SchedulerException {

        // Use the factory to create a Scheduler instance

        Scheduler scheduler = StdSchedulerFactory.getDefaultScheduler();

        // JobDetail holds the definition for Jobs

        JobDetail jobDetail =

new JobDetail("ScanFTPJob", Scheduler.DEFAULT_GROUP,

                ScanFTPSiteJob.class);

// Store job parameters to be used within execute()

jobDetail.getJobDataMap().put(

"FTP_HOST",

"""home""cavaness""inbound");

        // Other neccessary Job parameters here

        // Create a Trigger that fires every 60 seconds

        Trigger trigger = TriggerUtils.makeSecondlyTrigger(60);

        // Setup the Job and Trigger with the Scheduler

        scheduler.scheduleJob(jobDetail, trigger );

        // Start the Scheduler running

        scheduler.start();

    }

}

編程調(diào)度同聲明性調(diào)度

例3中，我們通過(guò)編程的方法調(diào)度我們的ScanFTPSiteJob作業(yè)。就是說(shuō)，我們用java代碼來(lái)設(shè)置作業(yè)和觸發(fā)器。Quartz框架也支持在xml文件里面申明性的設(shè)置作業(yè)調(diào)度。申明性方法允許我們更快速地修改哪個(gè)作業(yè)什么時(shí)候被執(zhí)行。

Quartz框架有一個(gè)插件，這個(gè)插件負(fù)責(zé)讀取xml配置文件。xml配置文件包含了關(guān)于啟 動(dòng)Quartz應(yīng)用的作業(yè)和觸發(fā)器信息。所有xml文件中的作業(yè)連同相關(guān)的觸發(fā)器都被加進(jìn)調(diào)度器。你仍然需要編寫(xiě)作業(yè)類(lèi)，但配置那些作業(yè)類(lèi)的調(diào)度器則非常 動(dòng)態(tài)化。例4展示了一個(gè)用申明性方式執(zhí)行與例3代碼相同的邏輯的xml配置文件。

例4．能使用xml文件調(diào)度的作業(yè)

            ScanFTPSiteJob

            DEFAULT

                A job that scans an ftp site for files

            ScanFTPSiteJob

                    FTP_HOST

                    "home"cavaness"inbound

                ScanFTPSiteJobTrigger

                DEFAULT

                ScanFTPSiteJob

                DEFAULT

                2005-09-11 6:10:00 PM

                -1

                60000

你可以將xml文件中的元素跟例3代碼作個(gè)比較，它們從概念上來(lái)看是相同的。使用例4式的申明性方法的好處是維護(hù)變得極其簡(jiǎn)單，只需改變xml配置文件和重新啟動(dòng)Quartz應(yīng)用即可。無(wú)須修改代碼，無(wú)須重新編譯，無(wú)須重新部署。

有狀態(tài)和無(wú)狀態(tài)作業(yè)

在本文中你所看到的作業(yè)到是無(wú)狀態(tài)的。這意味著在兩次作業(yè)執(zhí)行之間，不會(huì)去維護(hù)作業(yè)執(zhí)行時(shí)JobDataMap的狀態(tài)改變。如果你需要能增、刪，改JobDataMap的值，而且能讓作業(yè)在下次執(zhí)行時(shí)能看到這個(gè)狀態(tài)改變，則需要用Quartz有狀態(tài)作業(yè)。

如果你是一個(gè)有經(jīng)驗(yàn)的EJB開(kāi)發(fā)者的話，深信你會(huì)立即退縮，因?yàn)橛袪顟B(tài)帶有負(fù)面含義。這主要 是由于EJB帶來(lái)的伸縮性問(wèn)題。Quartz有狀態(tài)作業(yè)實(shí)現(xiàn)了org.quartz.StatefulJob接口。無(wú)狀態(tài)和有狀態(tài)作業(yè)的關(guān)鍵不同是有狀態(tài) 作業(yè)在每次執(zhí)行時(shí)只有一個(gè)實(shí)例。大多數(shù)情況下，有狀態(tài)的作業(yè)不回帶來(lái)大的問(wèn)題。然而，如果你有一個(gè)需要頻繁執(zhí)行的作業(yè)或者需要很長(zhǎng)時(shí)間才能完成的作業(yè)，那 么有狀態(tài)作業(yè)可能給你帶來(lái)伸縮性問(wèn)題。

Quartz框架的其他特征

Quartz框架有一個(gè)豐富的特征集。事實(shí)上，quarts有太多特性以致不能在一種情況中全部領(lǐng)會(huì)，下面列出了一些有意思的特征，但沒(méi)時(shí)間在此詳細(xì)討論。

監(jiān)聽(tīng)器和插件

每個(gè)人都喜歡監(jiān)聽(tīng)和插件。今天，幾乎下載任何開(kāi)源框架，你必定會(huì)發(fā)現(xiàn)支持這兩個(gè)概念。監(jiān)聽(tīng)是 你創(chuàng)建的java類(lèi)，當(dāng)關(guān)鍵事件發(fā)生時(shí)會(huì)收到框架的回調(diào)。例如，當(dāng)一個(gè)作業(yè)被調(diào)度、沒(méi)有調(diào)度或觸發(fā)器終止和不再打火時(shí)，這些都可以通過(guò)設(shè)置來(lái)來(lái)通知你的監(jiān) 聽(tīng)器。Quartz框架包含了調(diào)度器監(jiān)聽(tīng)、作業(yè)和觸發(fā)器監(jiān)聽(tīng)。你可以配置作業(yè)和觸發(fā)器監(jiān)聽(tīng)為全局監(jiān)聽(tīng)或者是特定于作業(yè)和觸發(fā)器的監(jiān)聽(tīng)。

一旦你的一個(gè)具體監(jiān)聽(tīng)被調(diào)用，你就能使用這個(gè)技術(shù)來(lái)做一些你想要在監(jiān)聽(tīng)類(lèi)里面做的事情。例 如，你如果想要在每次作業(yè)完成時(shí)發(fā)送一個(gè)電子郵件，你可以將這個(gè)邏輯寫(xiě)進(jìn)作業(yè)里面，也可以JobListener里面。寫(xiě)進(jìn)JobListener的方式 強(qiáng)制使用松耦合有利于設(shè)計(jì)上做到更好。

Quartz插件是一個(gè)新的功能特性，無(wú)須修改Quartz源碼便可被創(chuàng)建和添加進(jìn) Quartz框架。他為想要擴(kuò)展Quartz框架又沒(méi)有時(shí)間提交改變給Quartz開(kāi)發(fā)團(tuán)隊(duì)和等待新版本的開(kāi)發(fā)人員而設(shè)計(jì)。如果你熟悉Struts插件的 話，那么完全可以理解Quartz插件的使用。

與其Quartz提供一個(gè)不能滿足你需要的有限擴(kuò)展點(diǎn)，還不如通過(guò)使用插件來(lái)?yè)碛锌尚拚臄U(kuò)展點(diǎn)。

集群Quartz應(yīng)用

Quartz應(yīng)用能被集群，是水平集群還是垂直集群取決于你自己的需要。集群提供以下好處：

·        伸縮性

·        搞可用性

·        負(fù)載均衡

目前，Quartz只能借助關(guān)系數(shù)據(jù)庫(kù)和JDBC作業(yè)存儲(chǔ)支持集群。將來(lái)的版本這個(gè)制約將消失并且用RAMJobStore集群將是可能的而且將不需要數(shù)據(jù)庫(kù)的支持。

Quartz web應(yīng)用

使用框架幾個(gè)星期或幾個(gè)月后，Quartz用戶所顯示的需求之一是需要集成Quartz到圖 形用戶界面中。目前Quartz框架已經(jīng)有一些工具允許你使用Java servlet來(lái)初始化和啟動(dòng)Quartz。一旦你可以訪問(wèn)調(diào)度器實(shí)例，你就可以把它存儲(chǔ)在web容器的servlet上下文中 （ServletContext中）并且可以通過(guò)調(diào)度器接口管理調(diào)度環(huán)境。

幸運(yùn)的是一些開(kāi)發(fā)者已正影響著單機(jī)Quartz web應(yīng)用，它用來(lái)更好地管理調(diào)度器環(huán)境。構(gòu)建在若干個(gè)流行開(kāi)源框架如Struts和Spring之上的圖形用戶界面支持很多功能，這些功能都被包裝進(jìn)一個(gè)簡(jiǎn)單接口。GUI的一個(gè)畫(huà)面如圖1所示：

圖1.Quartz Web應(yīng)用允許比較容易地管理Quartz環(huán)境。

Quartz的下一步計(jì)劃

Quartz是一個(gè)活動(dòng)中的工程。Quartz開(kāi)發(fā)團(tuán)隊(duì)明確表示不會(huì)停留在已有的榮譽(yù)上。Quartz下一個(gè)主要版本已經(jīng)在啟動(dòng)中。你可以在OpenSymphony的 wiki上體驗(yàn)一下Quartz 2.0的設(shè)計(jì)和特征。

總之，Quartz用戶每天都自由地添加特性建議和設(shè)計(jì)創(chuàng)意以便能被核心框架考慮（看重）。

了解更多Quartz特征

當(dāng)你開(kāi)始使用Quartz框架的更多特性時(shí)，User and Developer Forum論壇變成一個(gè)回答問(wèn)題和跟其他Quartz用戶溝通的極其有用的資源。經(jīng)常去逛逛這個(gè)論壇時(shí)很有好處的，你也可以依靠James House來(lái)共享與你的需要相關(guān)的知識(shí)和意見(jiàn)。

這個(gè)論壇時(shí)免費(fèi)的，你不必登陸便可以查找和查看歸檔文件。然而，如果你覺(jué)得這個(gè)論壇比較好而且需要向某人回復(fù)問(wèn)題時(shí)，你必須得申請(qǐng)一個(gè)免費(fèi)帳號(hào)并用該帳號(hào)登陸。