原文地址：Getting Started with Quartz Scheduler
本文中“工作”對(duì)應(yīng)“job”仿吞，“任務(wù)”對(duì)應(yīng)“task”昏滴。關(guān)系是工作是若干任務(wù)的集合秃嗜，任務(wù)是工作中需要做的具體事情惑申。通俗的例子岩睁，“教師”是一個(gè)“工作”歧寺，它包含的具體“任務(wù)”有{“備課”绵跷，“上課”膘螟，“批改作業(yè)”，... }

什么是Quartz Scheduler碾局？

Quartz Scheduler是一個(gè)功能豐富的開(kāi)源的工作調(diào)度庫(kù)荆残，可以被真實(shí)地整合到任何Java應(yīng)用中－－從最小的獨(dú)立應(yīng)用到最大的電商系統(tǒng)。Quartz可以被用來(lái)構(gòu)建簡(jiǎn)單或者復(fù)雜的調(diào)度净当，用來(lái)執(zhí)行十個(gè)内斯、百個(gè)或者甚至萬(wàn)個(gè)工作。任務(wù)被定義為標(biāo)準(zhǔn)的Java組件像啼，這些組件會(huì)真實(shí)地執(zhí)行任何你通過(guò)編程指定給它們的事情俘闯。Quartz Schedulers包含了許多的企業(yè)級(jí)類(lèi)的特性，比如它支持JTA事務(wù)和集群忽冻。

Quartz可以為你做什么真朗？

如果你的應(yīng)用中有一些任務(wù)需要在給定的一個(gè)時(shí)候及時(shí)地執(zhí)行，或者如果你的系統(tǒng)有一些循環(huán)的維護(hù)工作僧诚，那么Quartz會(huì)是你理想中的解決方案遮婶。
使用Quartz來(lái)工作調(diào)度例子：

• 驅(qū)動(dòng)過(guò)程工作流：當(dāng)一個(gè)新的訂單被初始化后，調(diào)度一個(gè)工作來(lái)在2個(gè)小時(shí)內(nèi)精確的執(zhí)行湖笨，它會(huì)檢查訂單的狀態(tài)旗扑。并且如果一個(gè)關(guān)于這個(gè)訂單確認(rèn)信息還沒(méi)有收到的話(huà)，會(huì)觸發(fā)一個(gè)警告通知慈省，同時(shí)改變訂單的狀態(tài)為“等待介入”臀防。
• 系統(tǒng)維護(hù)：調(diào)度一個(gè)工作在每個(gè)工作日的11:30PM，去將數(shù)據(jù)庫(kù)的內(nèi)容倒入一個(gè)XML文件边败。
• 在一個(gè)應(yīng)用中提供提醒服務(wù)袱衷。

Quartz特色功能

運(yùn)行時(shí)環(huán)境

• Quartz可以嵌入式地運(yùn)行在另一個(gè)完全獨(dú)立的應(yīng)用中
• Quartz可以在一個(gè)應(yīng)用服務(wù)器（或者servlet容器）中被實(shí)例化，并且加入到XA事務(wù)中
• Quartz可以作為一個(gè)獨(dú)立的程序運(yùn)行（使用它自己的JVM）笑窜，通過(guò)RMI的方式被使用
• Quartz可以作為一個(gè)獨(dú)立程序（有著負(fù)載均衡和容錯(cuò)能力）的集群被實(shí)例化祟昭，來(lái)執(zhí)行工作

工作調(diào)度

當(dāng)一個(gè)給定的觸發(fā)器發(fā)生的時(shí)候，工作將被調(diào)度怖侦。觸發(fā)器幾乎可以被創(chuàng)建為任何下面的策略篡悟，包括：

• 一天中一個(gè)確定的時(shí)間（精確到毫秒）
• 一周中確定的日子
• 一月中確定的日子
• 一年中確定的日子
• 在一個(gè)注冊(cè)的日歷中排除一些確定的日子（比如法定假日）
• 重復(fù)一個(gè)確定的次數(shù)
• 重復(fù)直到一個(gè)確定的時(shí)間/日期
• 無(wú)限重復(fù)
• 延遲一段時(shí)間重復(fù)

工作被它們的創(chuàng)建者給定名字，并同樣可以通過(guò)組名將它們分組匾寝。觸發(fā)器同樣會(huì)被指定名字并放入組中搬葬，為了更容易地在調(diào)度過(guò)程中組織它們。工作可以被一次性地添加到調(diào)度器中艳悔，然而被多個(gè)觸發(fā)器所注冊(cè)急凰。在一個(gè)企業(yè)級(jí)的Java環(huán)境中，工作會(huì)執(zhí)行它們的任務(wù)作為一個(gè)分布式（XA）事務(wù)的一部分。

工作執(zhí)行

• 工作可以是任何實(shí)現(xiàn)了簡(jiǎn)單Job接口的Java類(lèi)抡锈，為你工作能做的事情留下了無(wú)限的可能疾忍。
• 工作類(lèi)的實(shí)例可以通過(guò)Quartz被實(shí)例化，活著通過(guò)你的應(yīng)用的框架床三。
• 當(dāng)一個(gè)觸發(fā)器發(fā)生的時(shí)候一罩，調(diào)度器會(huì)通知0個(gè)或更多Java對(duì)象去實(shí)現(xiàn)JobListener和TriggerListener接口（listener可以是簡(jiǎn)單的Java對(duì)象，或者EJB撇簿，或者JMS發(fā)布者聂渊，等等）。這些監(jiān)聽(tīng)器在工作執(zhí)行以后同樣會(huì)被通知四瘫。
• 當(dāng)工作完成汉嗽，它們返回一個(gè)JobCompletionCode來(lái)告訴調(diào)度器是成功還是失敗。JobCompletionCode同樣會(huì)指示調(diào)度器的任何它應(yīng)該根據(jù)成功/失敗碼所進(jìn)行的行為找蜜，比如立刻重新執(zhí)行工作饼暑。

工作持久化

• Quartz的設(shè)計(jì)包含了一個(gè)JobStore接口，它可以被實(shí)現(xiàn)來(lái)提供各種各樣的機(jī)制來(lái)存儲(chǔ)工作洗做。
• 通過(guò)使用JDBCJobStore弓叛，所有的工作和觸發(fā)器都被配置為“non-volatile”被通過(guò)JDBC存儲(chǔ)在一個(gè)關(guān)系型數(shù)據(jù)庫(kù)中。
• 通過(guò)使用RAMJobStore竭望，所有的工作和觸發(fā)器都被存在RAM中，并且在程序執(zhí)行之間不會(huì)持久化－－但是這有一個(gè)好處就是不需要一個(gè)外部的數(shù)據(jù)庫(kù)裕菠。

事務(wù)

• Quartz可以參與到JTA事務(wù)中咬清，通過(guò)使用JobStoreCMT（一個(gè)JDBCJobStore的子類(lèi)）。
• Quartz可以管理JTA事務(wù)（開(kāi)始并提交它們）在工作執(zhí)行的時(shí)候奴潘，以便于工作在做的事情在一個(gè)JTA事務(wù)中可以自動(dòng)地發(fā)生旧烧。

集群特性

• 提供容錯(cuò)
• 提供負(fù)載均衡
• Quartz的內(nèi)建集群特性依賴(lài)于通過(guò)JDBCJobStore的數(shù)據(jù)庫(kù)實(shí)例化。
• Terracotta對(duì)Quartz提供的擴(kuò)展提供了集群能力，而不需要一個(gè)后端的數(shù)據(jù)庫(kù)夺谁。

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

• 應(yīng)用可以通過(guò)實(shí)現(xiàn)一個(gè)或多個(gè)監(jiān)聽(tīng)器接口來(lái)捕獲調(diào)度時(shí)間來(lái)監(jiān)視或者控制job/trigger的行為。
• 插件機(jī)制可以被用來(lái)添加功能到Quartz匾鸥，如此保持一個(gè)工作執(zhí)行的歷史劳曹，或者從一個(gè)文件中加載job和trigger房资。
• Quartz通過(guò)整合一些“工廠構(gòu)建”插件和監(jiān)聽(tīng)器來(lái)運(yùn)行鳖擒。

下載和安裝Quartz

首先，從http://quartz-scheduler.org/downloads下載最新的穩(wěn)定版本。注冊(cè)不是必須的。解壓發(fā)行包并安裝使得你的應(yīng)用可以看到它。

Quartz的jar文件

Quartz的包里有若干jar文件替劈，在發(fā)行包的根目錄下眨业。主要的Quartz庫(kù)的名字叫做quartz-xxx.jar（xxx是版本號(hào)）皂股。為了使用任何Quartz的特性，這個(gè)jar必須放置在你應(yīng)用的classpath下面。
如果你使用Quartz主要在一個(gè)應(yīng)用服務(wù)器的環(huán)境喜鼓，你可以將Quartz JAR放置在你的應(yīng)用中（.ear或者.war文件）隅忿。如果你想使Quartz對(duì)于許多應(yīng)用都可用蝉揍，確保它在你應(yīng)用服務(wù)器中classpath下面捍掺。如果你正在一個(gè)獨(dú)立的應(yīng)用中使用它喂柒，將它放置在應(yīng)用的classpath下艳吠，并把你應(yīng)用所依賴(lài)的其它JAR文件也放置過(guò)去。
Quartz依賴(lài)若干第三方的庫(kù)（通過(guò)jar的形式），它們?cè)?zip發(fā)布包的lib目錄下。為了使用Quartz的所有特性，這些jar必須同樣存在于你的classpath下。如果你在構(gòu)建一個(gè)獨(dú)立的Quartz應(yīng)用，請(qǐng)?zhí)砑铀械膸?kù)到classpath下企蹭。

注意：在一個(gè)應(yīng)用服務(wù)器的環(huán)境送漠，如果環(huán)境中包含不同版本的相同的jar包爷狈，那么不可預(yù)見(jiàn)的結(jié)果可能會(huì)出現(xiàn)。比如，WebLogic包含一個(gè)J2EE的實(shí)現(xiàn)（在weblogic.jar里）贬堵，這有可能和servlet.jar中的那個(gè)不同蒸殿。在這種情況下充石，將servlet.jar排除在你的應(yīng)用之外通常是更好的做法惰爬，以便于你知道哪個(gè)類(lèi)正在被使用撕瞧。

屬性文件

Quartz使用一個(gè)叫做quartz.properties的屬性文件。這個(gè)文件最初不是必須的雅任，但是當(dāng)你想要使用任何基本配置以外的東西時(shí)沪么，就需要用到它州胳。當(dāng)你使用這個(gè)文件弛说，它必須在你的classpath下面淘讥。
如果你在構(gòu)建一個(gè)web應(yīng)用（比如，一個(gè).war文件的形式）榔至，你可以將quartz.properties文件放在WEB-INF/classes文件夾下抵赢，從而放置在了應(yīng)用的classpath下。

提示：如果你使用WebLogic Workshop開(kāi)發(fā)你的應(yīng)用枫弟，你可以保留你的配置文件（包括quartz.properties）在你應(yīng)用的根目錄下面的一個(gè)項(xiàng)目中邢享。當(dāng)你打包你的應(yīng)用到一個(gè).ear文件中時(shí)，配置項(xiàng)目將會(huì)把最終的.ear中包含的打包到一個(gè).jar中淡诗。這樣做將會(huì)自動(dòng)的將quartz.properties文件放置在你的classpath下骇塘。

配置Quartz調(diào)度器

為了配置Quartz伊履，你編輯quartz.properties文件，并把它放置在你的application的classpath下面款违。

注意：Quartz調(diào)度器的發(fā)布包中包含了若干quartz.properties文件的例子在example/directory中唐瀑。

下面的例子展示了一個(gè)基本的quartz.properties文件的內(nèi)容：

org.quartz.scheduler.instanceName = MyScheduler
org.quartz.threadPool.threadCount = 3
org.quartz.jobStore.class = org.quartz.simpl.RAMJobStore

這個(gè)例子指定了以下的屬性：

• org.quartz.scheduler.instanceName屬性為調(diào)度器分配了一個(gè)名字為“MyScheduler”。
• org.quartz.threadPool.threadCount屬性在線(xiàn)程池中分配了三個(gè)線(xiàn)程插爹，意味著最多三個(gè)job同時(shí)進(jìn)行哄辣。
• org.quartz.jobStore.class屬性配置調(diào)度器去使用RAMJobStore來(lái)進(jìn)行數(shù)據(jù)存儲(chǔ)。這意味著調(diào)度器將會(huì)保持這個(gè)job和trigger的數(shù)據(jù)在內(nèi)存中而不是數(shù)據(jù)庫(kù)赠尾。

開(kāi)始一個(gè)示例應(yīng)用

下面的代碼獲取一個(gè)調(diào)度器實(shí)力柔滔，啟動(dòng)它，然后關(guān)閉它萍虽。
Quartz.java

import org.quartz.Scheduler;
import org.quartz.SchedulerException;
import org.quartz.impl.StdSchedulerFactory;
import static org.quartz.JobBuilder.*;
import static org.quartz.TriggerBuilder.*;
import static org.quartz.SimpleScheduleBuilder.*;

注意：一旦你使用StdSchedulerFactory.getDefaultScheduler()獲得了一個(gè)調(diào)度器睛廊，你的應(yīng)用將會(huì)一直運(yùn)行直到你調(diào)用了scheduler.shutdown()。因?yàn)檫@將是活動(dòng)的線(xiàn)程杉编。

注意這里使用了static引入超全，這將在下面的代碼中發(fā)揮作用。
如果你還沒(méi)有設(shè)置日志邓馒，日志的信息將會(huì)被發(fā)送到console中嘶朱。你的輸出將像下面這樣：

[INFO] 21 Jan 08:46:27.857 AM main [org.quartz.core.QuartzScheduler]
Quartz Scheduler v.2.0.0-SNAPSHOT created.
[INFO] 21 Jan 08:46:27.859 AM main [org.quartz.simpl.RAMJobStore]
RAMJobStore initialized.
[INFO] 21 Jan 08:46:27.865 AM main [org.quartz.core.QuartzScheduler]
Scheduler meta-data: Quartz Scheduler (v2.0.0) 'Scheduler' with instanceId 'NON_CLUSTERED'
  Scheduler class: 'org.quartz.core.QuartzScheduler' - running locally.
  NOT STARTED.
  Currently in standby mode.
  Number of jobs executed: 0
  Using thread pool 'org.quartz.simpl.SimpleThreadPool' - with 50 threads.
  Using job-store 'org.quartz.simpl.RAMJobStore' - which does not support
        persistence. and is not clustered.
[INFO] 21 Jan 08:46:27.865 AM main [org.quartz.impl.StdSchedulerFactory]
Quartz scheduler 'Scheduler' initialized from default resource file in Quartz
         package: 'quartz.properties'
[INFO] 21 Jan 08:46:27.866 AM main [org.quartz.impl.StdSchedulerFactory]
Quartz scheduler version: 2.0.0
[INFO] 21 Jan 08:46:27.866 AM main [org.quartz.core.QuartzScheduler]
Scheduler Scheduler_$_NON_CLUSTERED started.
[INFO] 21 Jan 08:46:27.866 AM main [org.quartz.core.QuartzScheduler]
Scheduler Scheduler_$_NON_CLUSTERED shutting down.
[INFO] 21 Jan 08:46:27.866 AM main [org.quartz.core.QuartzScheduler]
Scheduler Scheduler_$_NON_CLUSTERED paused.
[INFO] 21 Jan 08:46:27.867 AM main [org.quartz.core.QuartzScheduler]
Scheduler Scheduler_$_NON_CLUSTERED shutdown complete.

為了做一些事情，你需要在start()和shutdown()的調(diào)用之間提供一些代碼光酣。你將同樣需要允許一些時(shí)候在調(diào)用shutdown()之前疏遏，對(duì)job進(jìn)行觸發(fā)和執(zhí)行。對(duì)于一個(gè)簡(jiǎn)單的像這樣的例子救军，你應(yīng)該調(diào)用：

Thread.sleep(60000);
// define the job and tie it to our HelloJob class
JobDetail job = newJob(HelloJob.class)
    .withIdentity("job1", "group1")
    .build();
// Trigger the job to run now, and then repeat every 40 seconds
Trigger trigger = newTrigger()
    .withIdentity("trigger1", "group1")
    .startNow()
    .withSchedule(simpleSchedule()
            .withIntervalInSeconds(40)
            .repeatForever())
    .build();
// Tell quartz to schedule the job using our trigger
scheduler.scheduleJob(job, trigger);