概述
了解Quartz體系結構
Quartz對任務調度的領域問題進行了高度的抽象，提出了調度器、任務和觸發(fā)器這3個核心的概念，并在org.quartz通過接口和類對重要的這些核心概念進行描述：
●Job：是一個接口，只有一個方法void execute(JobExecutionContext context)，開發(fā)者實現(xiàn)該接口定義運行任務，JobExecutionContext類提供了調度上下文的各種信息。Job運行時的信息保存在JobDataMap實例中；
●JobDetail：Quartz在每次執(zhí)行Job時，都重新創(chuàng)建一個Job實例，所以它不直接接受一個Job的實例，相反它接收一個Job實現(xiàn)類，以便運行時通過newInstance()的反射機制實例化Job。因此需要通過一個類來描述Job的實現(xiàn)類及其它相關的靜態(tài)信息，如Job名字、描述、關聯(lián)監(jiān)聽器等信息，JobDetail承擔了這一角色。
通過該類的構造函數(shù)可以更具體地了解它的功用：JobDetail(java.lang.String name, java.lang.String group, java.lang.Class jobClass)，該構造函數(shù)要求指定Job的實現(xiàn)類，以及任務在Scheduler中的組名和Job名稱；
●Trigger：是一個類，描述觸發(fā)Job執(zhí)行的時間觸發(fā)規(guī)則。主要有SimpleTrigger和CronTrigger這兩個子類。當僅需觸發(fā)一次或者以固定時間間隔周期執(zhí)行，SimpleTrigger是最適合的選擇；而CronTrigger則可以通過Cron表達式定義出各種復雜時間規(guī)則的調度方案：如每早晨9:00執(zhí)行，周一、周三、周五下午5:00執(zhí)行等；
●Calendar：org.quartz.Calendar和java.util.Calendar不同，它是一些日歷特定時間點的集合（可以簡單地將org.quartz.Calendar看作java.util.Calendar的集合——java.util.Calendar代表一個日歷時間點，無特殊說明后面的Calendar即指org.quartz.Calendar）。一個Trigger可以和多個Calendar關聯(lián)，以便排除或包含某些時間點。
假設，我們安排每周星期一早上10:00執(zhí)行任務，但是如果碰到法定的節(jié)日，任務則不執(zhí)行，這時就需要在Trigger觸發(fā)機制的基礎上使用Calendar進行定點排除。針對不同時間段類型，Quartz在org.quartz.impl.calendar包下提供了若干個Calendar的實現(xiàn)類，如AnnualCalendar、MonthlyCalendar、WeeklyCalendar分別針對每年、每月和每周進行定義；
●Scheduler：代表一個Quartz的獨立運行容器，Trigger和JobDetail可以注冊到Scheduler中，兩者在Scheduler中擁有各自的組及名稱，組及名稱是Scheduler查找定位容器中某一對象的依據(jù)，Trigger的組及名稱必須唯一，JobDetail的組和名稱也必須唯一（但可以和Trigger的組和名稱相同，因為它們是不同類型的）。Scheduler定義了多個接口方法，允許外部通過組及名稱訪問和控制容器中Trigger和JobDetail。
Scheduler可以將Trigger綁定到某一JobDetail中，這樣當Trigger觸發(fā)時，對應的Job就被執(zhí)行。一個Job可以對應多個Trigger，但一個Trigger只能對應一個Job。可以通過SchedulerFactory創(chuàng)建一個Scheduler實例。Scheduler擁有一個SchedulerContext，它類似于ServletContext，保存著Scheduler上下文信息，Job和Trigger都可以訪問SchedulerContext內(nèi)的信息。SchedulerContext內(nèi)部通過一個Map，以鍵值對的方式維護這些上下文數(shù)據(jù)，SchedulerContext為保存和獲取數(shù)據(jù)提供了多個put()和getXxx()的方法。可以通過Scheduler# getContext()獲取對應的SchedulerContext實例；
●ThreadPool：Scheduler使用一個線程池作為任務運行的基礎設施，任務通過共享線程池中的線程提高運行效率。
Job有一個StatefulJob子接口，代表有狀態(tài)的任務，該接口是一個沒有方法的標簽接口，其目的是讓Quartz知道任務的類型，以便采用不同的執(zhí)行方案。無狀態(tài)任務在執(zhí)行時擁有自己的JobDataMap拷貝，對JobDataMap的更改不會影響下次的執(zhí)行。而有狀態(tài)任務共享共享同一個JobDataMap實例，每次任務執(zhí)行對JobDataMap所做的更改會保存下來，后面的執(zhí)行可以看到這個更改，也即每次執(zhí)行任務后都會對后面的執(zhí)行發(fā)生影響。
正因為這個原因，無狀態(tài)的Job可以并發(fā)執(zhí)行，而有狀態(tài)的StatefulJob不能并發(fā)執(zhí)行，這意味著如果前次的StatefulJob還沒有執(zhí)行完畢，下一次的任務將阻塞等待，直到前次任務執(zhí)行完畢。有狀態(tài)任務比無狀態(tài)任務需要考慮更多的因素，程序往往擁有更高的復雜度，因此除非必要，應該盡量使用無狀態(tài)的Job。
如果Quartz使用了數(shù)據(jù)庫持久化任務調度信息，無狀態(tài)的JobDataMap僅會在Scheduler注冊任務時保持一次，而有狀態(tài)任務對應的JobDataMap在每次執(zhí)行任務后都會進行保存。
Trigger自身也可以擁有一個JobDataMap，其關聯(lián)的Job可以通過JobExecutionContext#getTrigger().getJobDataMap()獲取Trigger中的JobDataMap。不管是有狀態(tài)還是無狀態(tài)的任務，在任務執(zhí)行期間對Trigger的JobDataMap所做的更改都不會進行持久，也即不會對下次的執(zhí)行產(chǎn)生影響。
Quartz擁有完善的事件和監(jiān)聽體系，大部分組件都擁有事件，如任務執(zhí)行前事件、任務執(zhí)行后事件、觸發(fā)器觸發(fā)前事件、觸發(fā)后事件、調度器開始事件、關閉事件等等，可以注冊相應的監(jiān)聽器處理感興趣的事件。
圖1描述了Scheduler的內(nèi)部組件結構，SchedulerContext提供Scheduler全局可見的上下文信息，每一個任務都對應一個JobDataMap，虛線表達的JobDataMap表示對應有狀態(tài)的任務：
 500){this.resized=true;this.style.width=500;}" align=center>
圖1 Scheduler結構圖
一個Scheduler可以擁有多個Triger組和多個JobDetail組，注冊Trigger和JobDetail時，如果不顯式指定所屬的組，Scheduler將放入到默認組中，默認組的組名為Scheduler.DEFAULT_GROUP。組名和名稱組成了對象的全名，同一類型對象的全名不能相同。
Scheduler本身就是一個容器，它維護著Quartz的各種組件并實施調度的規(guī)則。Scheduler還擁有一個線程池，線程池為任務提供執(zhí)行線程——這比執(zhí)行任務時簡單地創(chuàng)建一個新線程要擁有更高的效率，同時通過共享節(jié)約資源的占用。通過線程池組件的支持，對于繁忙度高、壓力大的任務調度，Quartz將可以提供良好的伸縮性。
提示： Quartz完整下載包examples目錄下?lián)碛?0多個實例，它們是快速掌握Quartz應用很好的實例。
使用SimpleTrigger
SimpleTrigger擁有多個重載的構造函數(shù)，用以在不同場合下構造出對應的實例：
●SimpleTrigger(String name, String group)：通過該構造函數(shù)指定Trigger所屬組和名稱；
●SimpleTrigger(String name, String group, Date startTime)：除指定Trigger所屬組和名稱外，還可以指定觸發(fā)的開發(fā)時間；
●SimpleTrigger(String name, String group, Date startTime, Date endTime, int repeatCount, long repeatInterval)：除指定以上信息外，還可以指定結束時間、重復執(zhí)行次數(shù)、時間間隔等參數(shù)；
●SimpleTrigger(String name, String group, String jobName, String jobGroup, Date startTime, Date endTime, int repeatCount, long repeatInterval)：這是最復雜的一個構造函數(shù)，在指定觸發(fā)參數(shù)的同時，還通過jobGroup和jobName，讓該Trigger和Scheduler中的某個任務關聯(lián)起來。
通過實現(xiàn) org.quartz..Job 接口，可以使 Java 類化身為可調度的任務。代碼清單1提供了 Quartz 任務的一個示例：
代碼清單1 SimpleJob：簡單的Job實現(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  {
①實例Job接口方法
  public void execute(JobExecutionContext jobCtx)throws JobExecutionException {
System.out.println(jobCtx.getTrigger().getName()+ " triggered. time is:" + (new Date()));
 }
 }
這個類用一條非常簡單的輸出語句實現(xiàn)了Job接口的execute(JobExecutionContext context) 方法，這個方法可以包含想要執(zhí)行的任何代碼。下面，我們通過SimpleTrigger對SimpleJob進行調度：
代碼清單2 SimpleTriggerRunner：使用SimpleTrigger進行調度
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)建一個JobDetail實例，指定SimpleJob
JobDetail jobDetail = new JobDetail("job1_1","jGroup1", SimpleJob.class);
②通過SimpleTrigger定義調度規(guī)則：馬上啟動，每2秒運行一次，共運行100次
SimpleTrigger simpleTrigger = new SimpleTrigger("trigger1_1","tgroup1");
simpleTrigger.setStartTime(new Date());
simpleTrigger.setRepeatInterval(2000);
simpleTrigger.setRepeatCount(100);
③通過SchedulerFactory獲取一個調度器實例
SchedulerFactory schedulerFactory = new StdSchedulerFactory();
Scheduler scheduler = schedulerFactory.getScheduler();
scheduler.scheduleJob(jobDetail, simpleTrigger);④ 注冊并進行調度
scheduler.start();⑤調度啟動
} catch (Exception e) {
e.printStackTrace();
}
}
}
首先在①處通過JobDetail封裝SimpleJob，同時指定Job在Scheduler中所屬組及名稱，這里，組名為jGroup1，而名稱為job1_1。
在②處創(chuàng)建一個SimpleTrigger實例，指定該Trigger在Scheduler中所屬組及名稱。接著設置調度的時間規(guī)則。
最后，需要創(chuàng)建Scheduler實例，并將JobDetail和Trigger實例注冊到Scheduler中。這里，我們通過StdSchedulerFactory獲取一個Scheduler實例，并通過scheduleJob(JobDetail jobDetail, Trigger trigger)完成兩件事：
1)將JobDetail和Trigger注冊到Scheduler中；
2)將Trigger指派給JobDetail，將兩者關聯(lián)起來。
當Scheduler啟動后，Trigger將定期觸發(fā)并執(zhí)行SimpleJob的execute(JobExecutionContext jobCtx)方法，然后每 10 秒重復一次，直到任務被執(zhí)行 100 次后停止。
還可以通過SimpleTrigger的setStartTime(java.util.Date startTime)和setEndTime(java.util.Date endTime)指定運行的時間范圍，當運行次數(shù)和時間范圍沖突時，超過時間范圍的任務運行不被執(zhí)行。如可以通過simpleTrigger.setStartTime(new Date(System.currentTimeMillis() + 60000L))指定60秒鐘以后開始。
除了通過scheduleJob(jobDetail, simpleTrigger)建立Trigger和JobDetail的關聯(liá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：指定關聯(lián)的Job組名
simpleTrigger.setJobName("job1_1");①-2：指定關聯(lián)的Job名稱
scheduler.addJob(jobDetail, true);② 注冊JobDetail
scheduler.scheduleJob(simpleTrigger);③ 注冊指定了關聯(lián)JobDetail的Trigger
在這種方式中，Trigger通過指定Job所屬組及Job名稱，然后使用Scheduler的scheduleJob(Trigger trigger)方法注冊Trigger。有兩個值得注意的地方：
通過這種方式注冊的Trigger實例必須已經(jīng)指定Job組和Job名稱，否則調用注冊Trigger的方法將拋出異常；
引用的JobDetail對象必須已經(jīng)存在于Scheduler中。也即，代碼中①、②和③的先后順序不能互換。
在構造Trigger實例時，可以考慮使用org.quartz.TriggerUtils工具類，該工具類不但提供了眾多獲取特定時間的方法，還擁有眾多獲取常見Trigger的方法，如makeSecondlyTrigger(String trigName)方法將創(chuàng)建一個每秒執(zhí)行一次的Trigger，而makeWeeklyTrigger(String trigName, int dayOfWeek, int hour, int minute)將創(chuàng)建一個每星期某一特定時間點執(zhí)行一次的Trigger。而getEvenMinuteDate(Date date)方法將返回某一時間點一分鐘以后的時間。
使用CronTrigger
CronTrigger 能夠提供比 SimpleTrigger 更有具體實際意義的調度方案，調度規(guī)則基于 Cron 表達式，CronTrigger 支持日歷相關的重復時間間隔（比如每月第一個周一執(zhí)行），而不是簡單的周期時間間隔。因此，相對于SimpleTrigger而言，CronTrigger在使用上也要復雜一些。
Cron表達式
Quartz使用類似于Linux下的Cron表達式定義時間規(guī)則，Cron表達式由6或7個由空格分隔的時間字段組成，如表1所示：
表1 Cron表達式時間字段
|
位置
|
時間域名
|
允許值
|
允許的特殊字符
|
|
1
|
秒
|
0-59
|
, - * /
|
|
2
|
分鐘
|
0-59
|
, - * /
|
|
3
|
小時
|
0-23
|
, - * /
|
|
4
|
日期
|
1-31
|
, - * ? / L W C
|
|
5
|
月份
|
1-12
|
, - * /
|
|
6
|
星期
|
1-7
|
, - * ? / L C #
|
|
7
|
年(可選)
|
空值1970-2099
|
, - * /
|
Cron表達式的時間字段除允許設置數(shù)值外，還可使用一些特殊的字符，提供列表、范圍、通配符等功能，細說如下：
●星號(*)：可用在所有字段中，表示對應時間域的每一個時刻，例如，*在分鐘字段時，表示“每分鐘”；
●問號（?）：該字符只在日期和星期字段中使用，它通常指定為“無意義的值”，相當于點位符；
●減號(-)：表達一個范圍，如在小時字段中使用“10-12”，則表示從10到12點，即10,11,12；
●逗號(,)：表達一個列表值，如在星期字段中使用“MON,WED,FRI”，則表示星期一，星期三和星期五；
●斜杠(/)：x/y表達一個等步長序列，x為起始值，y為增量步長值。如在分鐘字段中使用0/15，則表示為0,15,30和45秒，而5/15在分鐘字段中表示5,20,35,50，你也可以使用*/y，它等同于0/y；
●L：該字符只在日期和星期字段中使用，代表“Last”的意思，但它在兩個字段中意思不同。L在日期字段中，表示這個月份的最后一天，如一月的31號，非閏年二月的28號；如果L用在星期中，則表示星期六，等同于7。但是，如果L出現(xiàn)在星期字段里，而且在前面有一個數(shù)值X，則表示“這個月的最后X天”，例如，6L表示該月的最后星期五；
●W：該字符只能出現(xiàn)在日期字段里，是對前導日期的修飾，表示離該日期最近的工作日。例如15W表示離該月15號最近的工作日，如果該月15號是星期六，則匹配14號星期五；如果15日是星期日，則匹配16號星期一；如果15號是星期二，那結果就是15號星期二。但必須注意關聯(lián)的匹配日期不能夠跨月，如你指定1W，如果1號是星期六，結果匹配的是3號星期一，而非上個月最后的那天。W字符串只能指定單一日期，而不能指定日期范圍；
●LW組合：在日期字段可以組合使用LW，它的意思是當月的最后一個工作日；
●井號(#)：該字符只能在星期字段中使用，表示當月某個工作日。如6#3表示當月的第三個星期五(6表示星期五，#3表示當前的第三個)，而4#5表示當月的第五個星期三，假設當月沒有第五個星期三，忽略不觸發(fā)；
● C：該字符只在日期和星期字段中使用，代表“Calendar”的意思。它的意思是計劃所關聯(lián)的日期，如果日期沒有被關聯(lián)，則相當于日歷中所有日期。例如5C在日期字段中就相當于日歷5日以后的第一天。1C在星期字段中相當于星期日后的第一天。
Cron表達式對特殊字符的大小寫不敏感，對代表星期的縮寫英文大小寫也不敏感。
表2下面給出一些完整的Cron表示式的實例：
表2 Cron表示式示例
|
表示式
|
說明
|
|
"0 0 12 * * ? "
|
每天12點運行
|
|
"0 15 10 ? * *"
|
每天10:15運行
|
|
"0 15 10 * * ?"
|
每天10:15運行
|
|
"0 15 10 * * ? *"
|
每天10:15運行
|
|
"0 15 10 * * ? 2008"
|
在2008年的每天10：15運行
|
|
"0 * 14 * * ?"
|
每天14點到15點之間每分鐘運行一次，開始于14:00，結束于14:59。
|
|
"0 0/5 14 * * ?"
|
每天14點到15點每5分鐘運行一次，開始于14:00，結束于14:55。
|
|
"0 0/5 14,18 * * ?"
|
每天14點到15點每5分鐘運行一次，此外每天18點到19點每5鐘也運行一次。
|
|
"0 0-5 14 * * ?"
|
每天14:00點到14:05，每分鐘運行一次。
|
|
"0 10,44 14 ? 3 WED"
|
3月每周三的14:10分到14:44，每分鐘運行一次。
|
|
"0 15 10 ? * MON-FRI"
|
每周一，二，三，四，五的10:15分運行。
|
|
"0 15 10 15 * ?"
|
每月15日10:15分運行。
|
|
"0 15 10 L * ?"
|
每月最后一天10:15分運行。
|
|
"0 15 10 ? * 6L"
|
每月最后一個星期五10:15分運行。
|
|
"0 15 10 ? * 6L 2007-2009"
|
在2007,2008,2009年每個月的最后一個星期五的10:15分運行。
|
|
"0 15 10 ? * 6#3"
|
每月第三個星期五的10:15分運行。
|
CronTrigger實例
下面，我們使用CronTrigger對SimpleJob進行調度，通過Cron表達式制定調度規(guī)則，讓它每5秒鐘運行一次：
代碼清單3 CronTriggerRunner：使用CronTrigger進行調度
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表達式
cronTrigger.setCronExpression(cexp);①-3：設置Cron表達式
SchedulerFactory schedulerFactory = new StdSchedulerFactory();
Scheduler scheduler = schedulerFactory.getScheduler();
scheduler.scheduleJob(jobDetail, cronTrigger);
scheduler.start();
//②
} catch (Exception e) {
e.printStackTrace();
}
}
}
運行CronTriggerRunner，每5秒鐘將觸發(fā)運行SimpleJob一次。默認情況下Cron表達式對應當前的時區(qū)，可以通過CronTriggerRunner的setTimeZone(java.util.TimeZone timeZone)方法顯式指定時區(qū)。你還也可以通過setStartTime(java.util.Date startTime)和setEndTime(java.util.Date endTime)指定開始和結束的時間。
在代碼清單3的②處需要通過Thread.currentThread.sleep()的方式讓主線程睡眠，以便調度器可以繼續(xù)工作執(zhí)行任務調度。否則在調度器啟動后，因為主線程馬上退出，也將同時引起調度器關閉，調度器中的任務都將相應銷毀，這將導致看不到實際的運行效果。在單元測試的時候，讓主線程睡眠經(jīng)常使用的辦法。對于某些長周期任務調度的測試，你可以簡單地調整操作系統(tǒng)時間進行模擬。
使用Calendar
在實際任務調度中，我們不可能一成不變地按照某個周期性的調度規(guī)則運行任務，必須考慮到實現(xiàn)生活中日歷上特定日期，就象習慣了大男人作風的人在2月14號也會有不同表現(xià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();
②五一勞動節(jié)
Calendar laborDay = new GregorianCalendar();
laborDay.add(Calendar.MONTH,5);
laborDay.add(Calendar.DATE,1);
holidays.setDayExcluded(laborDay, true); ②-1：排除的日期，如果設置為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注冊日歷
Date runDate = TriggerUtils.getDateOf(0,0, 10, 1, 4);⑤4月1號 上午10點
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應用指定的日歷規(guī)則
scheduler.scheduleJob(job, trigger);
scheduler.start();
//實際應用中主線程不能停止，否則Scheduler得不到執(zhí)行，此處從略
}
}
由于節(jié)日是每年重復的，所以使用org.quartz.Calendar的AnnualCalendar實現(xiàn)類，通過②、③的代碼，指定五一和國慶兩個節(jié)日并通過AnnualCalendar#setDayExcluded(Calendar day, boolean exclude)方法添加這兩個日期。exclude為true時表示排除指定的日期，如果為false時表示包含指定的日期。
在定制好org.quartz.Calendar后，還需要通過Scheduler#addCalendar(String calName, Calendar calendar, boolean replace, boolean updateTriggers)進行注冊，如果updateTriggers為true，Scheduler中已引用Calendar的Trigger將得到更新，如④所示。
在⑥處，我們讓一個Trigger指定使用Scheduler中代表節(jié)日的Calendar，這樣Trigger就會避開五一和國慶這兩個特殊日子了。
任務調度信息存儲
在默認情況下Quartz將任務調度的運行信息保存在內(nèi)存中，這種方法提供了最佳的性能，因為內(nèi)存中數(shù)據(jù)訪問最快。不足之處是缺乏數(shù)據(jù)的持久性，當程序路途停止或系統(tǒng)崩潰時，所有運行的信息都會丟失。
比如我們希望安排一個執(zhí)行100次的任務，如果執(zhí)行到50次時系統(tǒng)崩潰了，系統(tǒng)重啟時任務的執(zhí)行計數(shù)器將從0開始。在大多數(shù)實際的應用中，我們往往并不需要保存任務調度的現(xiàn)場數(shù)據(jù)，因為很少需要規(guī)劃一個指定執(zhí)行次數(shù)的任務。
對于僅執(zhí)行一次的任務來說，其執(zhí)行條件信息本身應該是已經(jīng)持久化的業(yè)務數(shù)據(jù)（如鎖定到期解鎖任務，解鎖的時間應該是業(yè)務數(shù)據(jù)），當執(zhí)行完成后，條件信息也會相應改變。當然調度現(xiàn)場信息不僅僅是記錄運行次數(shù)，還包括調度規(guī)則、JobDataMap中的數(shù)據(jù)等等。
如果確實需要持久化任務調度信息，Quartz允許你通過調整其屬性文件，將這些信息保存到數(shù)據(jù)庫中。使用數(shù)據(jù)庫保存任務調度信息后，即使系統(tǒng)崩潰后重新啟動，任務的調度信息將得到恢復。如前面所說的例子，執(zhí)行50次崩潰后重新運行，計數(shù)器將從51開始計數(shù)。使用了數(shù)據(jù)庫保存信息的任務稱為持久化任務。
通過配置文件調整任務調度信息的保存策略
其實Quartz JAR文件的org.quartz包下就包含了一個quartz.properties屬性配置文件并提供了默認設置。如果需要調整默認配置，可以在類路徑下建立一個新的quartz.properties，它將自動被Quartz加載并覆蓋默認的設置。
先來了解一下Quartz的默認屬性配置文件：
代碼清單5 quartz.properties：默認配置
①集群的配置，這里不使用集群
org.quartz.scheduler.instanceName = DefaultQuartzScheduler
org.quartz.scheduler.rmi.export = false
org.quartz.scheduler.rmi.proxy = false
org.quartz.scheduler.wrapJobExecutionInUserTransaction = false
②配置調度器的線程池
org.quartz.threadPool.class = org.quartz.simpl.SimpleThreadPool
org.quartz.threadPool.threadCount = 10
org.quartz.threadPool.threadPriority = 5
org.quartz.threadPool.threadsInheritContextClassLoaderOfInitializingThread = true
③配置任務調度現(xiàn)場數(shù)據(jù)保存機制
org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore
Quartz的屬性配置文件主要包括三方面的信息：
1)集群信息；
2)調度器線程池；
3)任務調度現(xiàn)場數(shù)據(jù)的保存。
如果任務數(shù)目很大時，可以通過增大線程池的大小得到更好的性能。默認情況下，Quartz采用org.quartz.simpl.RAMJobStore保存任務的現(xiàn)場數(shù)據(jù)，顧名思義，信息保存在RAM內(nèi)存中，我們可以通過以下設置將任務調度現(xiàn)場數(shù)據(jù)保存到數(shù)據(jù)庫中：
代碼清單6 quartz.properties：使用數(shù)據(jù)庫保存任務調度現(xiàn)場數(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
要將任務調度數(shù)據(jù)保存到數(shù)據(jù)庫中，就必須使用org.quartz.impl.jdbcjobstore.JobStoreTX代替原來的org.quartz.simpl.RAMJobStore并提供相應的數(shù)據(jù)庫配置信息。首先①處指定了Quartz數(shù)據(jù)庫表的前綴，在②處定義了一個數(shù)據(jù)源，在③處具體定義這個數(shù)據(jù)源的連接信息。
你必須事先在相應的數(shù)據(jù)庫中創(chuàng)建Quartz的數(shù)據(jù)表（共8張），在Quartz的完整發(fā)布包的docs/dbTables目錄下?lián)碛袑煌瑪?shù)據(jù)庫的SQL腳本。
查詢數(shù)據(jù)庫中的運行信息
任務的現(xiàn)場保存對于上層的Quartz程序來說是完全透明的，我們在src目錄下編寫一個如代碼清單6所示的quartz.properties文件后，重新運行代碼清單2或代碼清單3的程序，在數(shù)據(jù)庫表中將可以看到對應的持久化信息。當調度程序運行過程中途停止后，任務調度的現(xiàn)場數(shù)據(jù)將記錄在數(shù)據(jù)表中，在系統(tǒng)重啟時就可以在此基礎上繼續(xù)進行任務的調度。
代碼清單7 JDBCJobStoreRunner：從數(shù)據(jù)庫中恢復任務的調度
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();
①獲取調度器中所有的觸發(fā)器組
String[] triggerGroups = scheduler.getTriggerGroupNames();
②重新恢復在tgroup1組中，名為trigger1_1觸發(fā)器的運行
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:恢復運行
scheduler.rescheduleJob(triggers[j], triggerGroups[i],tg);
}
}
}
scheduler.start();
} catch (Exception e) {
e.printStackTrace();
}
}
}
當代碼清單2中的SimpleTriggerRunner執(zhí)行到一段時間后非正常退出，我們就可以通過這個JDBCJobStoreRunner根據(jù)記錄在數(shù)據(jù)庫中的現(xiàn)場數(shù)據(jù)恢復任務的調度。Scheduler中的所有Trigger以及JobDetail的運行信息都會保存在數(shù)據(jù)庫中，這里我們僅恢復tgroup1組中名稱為trigger1_1的觸發(fā)器，這可以通過如②-1所示的代碼進行過濾，觸發(fā)器的采用GROUP.TRIGGER_NAME的全名格式。通過Scheduler#rescheduleJob(String triggerName,String groupName,Trigger newTrigger)即可重新調度關聯(lián)某個Trigger的任務。
下面我們來觀察一下不同時期qrtz_simple_triggers表的數(shù)據(jù)：
1．運行代碼清單2的SimpleTriggerRunner一小段時間后退出：
 500){this.resized=true;this.style.width=500;}" align=center resized="true">
REPEAT_COUNT表示需要運行的總次數(shù)，而TIMES_TRIGGER表示已經(jīng)運行的次數(shù)。
2．運行代碼清單7的JDBCJobStoreRunner恢復trigger1_1的觸發(fā)器，運行一段時間后退出，這時qrtz_simple_triggers中的數(shù)據(jù)如下：
 500){this.resized=true;this.style.width=500;}" align=center resized="true">
首先Quartz會將原REPEAT_COUNT-TIMES_TRIGGER得到新的REPEAT_COUNT值，并記錄已經(jīng)運行的次數(shù)（重新從0開始計算）。
3．重新啟動JDBCJobStoreRunner運行后，數(shù)據(jù)又將發(fā)生相應的變化：
 500){this.resized=true;this.style.width=500;}" align=center resized="true">
4．繼續(xù)運行直至完成所有剩余的次數(shù)，再次查詢qrtz_simple_triggers表：
 500){this.resized=true;this.style.width=500;}" align=center resized="true">
這時，該表中的記錄已經(jīng)變空。
值得注意的是，如果你使用JDBC保存任務調度數(shù)據(jù)時，當你運行代碼清單2的SimpleTriggerRunner然后退出，當再次希望運行SimpleTriggerRunner時，系統(tǒng)將拋出JobDetail重名的異常：
Unable to store Job with name: 'job1_1' and group: 'jGroup1', because one already exists with this identification.
因為每次調用Scheduler#scheduleJob()時，Quartz都會將JobDetail和Trigger的信息保存到數(shù)據(jù)庫中，如果數(shù)據(jù)表中已經(jīng)同名的JobDetail或Trigger，異常就產(chǎn)生了。
本文使用quartz 1.6版本，我們發(fā)現(xiàn)當后臺數(shù)據(jù)庫使用MySql時，數(shù)據(jù)保存不成功，該錯誤是Quartz的一個Bug，相信會在高版本中得到修復。因為HSQLDB不支持SELECT * FROM TABLE_NAME FOR UPDATE的語法，所以不能使用HSQLDB數(shù)據(jù)庫。
小結
Quartz提供了最為豐富的任務調度功能，不但可以制定周期性運行的任務調度方案，還可以讓你按照日歷相關的方式進行任務調度。Quartz框架的重要組件包括Job、JobDetail、Trigger、Scheduler以及輔助性的JobDataMap和SchedulerContext。
Quartz擁有一個線程池，通過線程池為任務提供執(zhí)行線程，你可以通過配置文件對線程池進行參數(shù)定制。Quartz的另一個重要功能是可將任務調度信息持久化到數(shù)據(jù)庫中，以便系統(tǒng)重啟時能夠恢復已經(jīng)安排的任務。此外，Quartz還擁有完善的事件體系，允許你注冊各種事件的監(jiān)聽器。
|