一、Quartz可以用來做什么
Quartz是一個強大任務調度框架，我工作時候會在這些情況下使用到quartz框架，當然還有很多的應用場景，在這里只列舉2個實際用到的
- 餐廳系統會在每周四晚上的22點自動審核並生成報表
-
人事系統會在每天早晨8點給有待辦的人員自動發送Email提醒
二、使用Quartz之前的准備
1.建立一個Maven項目
2.引入quartz的依賴
使用quartz，我們僅僅需要在maven的pom文件中添加依賴即可。我使用的是現在最新的一個版本2.3.0，大家可以在maven的倉庫獲取到最新的版本依賴，地址：http://mvnrepository.com/artifact/org.quartz-scheduler/quartz
但然也可以使用這個2.3.0的依賴，下面的例子都是使用此依賴並實現了效果。
<!-- https://mvnrepository.com/artifact/org.quartz-scheduler/quartz --> <dependency> <groupId>org.quartz-scheduler</groupId> <artifactId>quartz</artifactId> <version>2.3.0</version> </dependency>
三、編寫第一個Quartz任務案例 - 每隔2秒鍾打印一次HelloQuartz
先實現一下這個基本的Quartz的任務再來介紹一下Quartz的3個重要組成，JobDetail，Trigger，Scheduler
1.創建一個類 HelloJob.java，這個類是編寫我們的具體要實現任務（打印Hello Quartz）
import org.quartz.Job;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;
import java.text.SimpleDateFormat;
import java.util.Date;
public class HelloJob implements Job{ public void execute(JobExecutionContext jobExecutionContext) throws JobExecutionException { //打印當前的執行時間 例如 2017-11-23 00:00:00 Date date = new Date(); SimpleDateFormat sf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); System.out.println("現在的時間是："+ sf.format(date)); //具體的業務邏輯 System.out.println("Hello Quartz"); } }
2.創建一個類HelloScheduler.java，這個是具體觸發我們的任務
public class HelloScheduler { public static void main(String[] args) throws SchedulerException { //創建一個jobDetail的實例，將該實例與HelloJob Class綁定 JobDetail jobDetail = JobBuilder.newJob(HelloJob.class).withIdentity("myJob").build(); //創建一個Trigger觸發器的實例，定義該job立即執行，並且每2秒執行一次，一直執行 SimpleTrigger trigger = TriggerBuilder.newTrigger().withIdentity("myTrigger").startNow().withSchedule(SimpleScheduleBuilder.simpleSchedule().withIntervalInSeconds(2).repeatForever()).build(); //創建schedule實例 StdSchedulerFactory factory = new StdSchedulerFactory(); Scheduler scheduler = factory.getScheduler(); scheduler.start(); scheduler.scheduleJob(jobDetail,trigger); } }
3.執行main方法，Run 'HelloScheduler.main()'，可以看見如下效果，表明任務執行成功了
4.一句話看懂quartz
1、創建調度工廠(); //工廠模式
四、第二個案例 - 每日的9點40分觸發任務打印HelloQuartz
與上一個的簡單案例的區別在於，SimpleTrigger/CronTrigger. 簡單的定時任務,可以采用SimpleTrigger,復雜的任務一般采用CronTrigger.cronTrigger不僅可以設定單的觸發時間表,更可以設定非常復雜的觸發時間表。 CronTrigger 是基於 Unix類似於 cron 表達式,如果對cron表達式比較熟悉,那么學習起來經非常簡單. 即使對cron表達式不熟悉,花一會兒的功夫也可以學會。（在工作中我們直接使用網上的在線生成表達式即可又快又准確）生成地址：http://cron.qqe2.com/
先上代碼，然后介紹一下cron表達式生成規則。
1.編寫任務類 HelloJob.java，具體情況編寫具體內容，如生成報表，發送郵件。。
public class HelloJob implements Job{ public void execute(JobExecutionContext jobExecutionContext) throws JobExecutionException { //打印當前的執行時間 例如 2017-11-22 00:00:00 Date date = new Date(); SimpleDateFormat sf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); System.out.println("現在的時間是："+ sf.format(date)); //具體的業務邏輯 System.out.println("開始生成任務報表 或 開始發送郵件"); } }
2.編寫任務觸發類 CronScheduler.java
public class CronScheduler { public static void main(String[] args) throws SchedulerException, InterruptedException { //jobDetail JobDetail jobDetail = JobBuilder.newJob(HelloJob.class).withIdentity("cronJob").build(); //cronTrigger //每日的9點40觸發任務 CronTrigger cronTrigger = TriggerBuilder.newTrigger().withIdentity("cronTrigger").withSchedule(CronScheduleBuilder.cronSchedule("0 40 9 * * ? ")).build(); //1.每日10點15分觸發 0 15 10 ？* * //2.每天下午的2點到2點59分（正點開始，隔5分觸發） 0 0/5 14 * * ? //3.從周一到周五每天的上午10點15觸發 0 15 10 ? MON-FRI //4.每月的第三周的星期五上午10點15觸發 0 15 10 ? * 6#3 //5.2016到2017年每月最后一周的星期五的10點15分觸發 0 15 10 ? * 6L 2016-2017 //Scheduler實例 StdSchedulerFactory stdSchedulerFactory = new StdSchedulerFactory(); Scheduler scheduler = stdSchedulerFactory.getScheduler(); scheduler.start(); scheduler.scheduleJob(jobDetail,cronTrigger); } }
3.觸發的效果
五、cron表達式編寫規則
1. Quartz Cron 表達式支持7個域 ,分別是秒/分/時/日/月/周/年.期中年是非必須項.如下圖
| 名稱 | 是否必須 | 允許值 | 特殊字符 |
|---|---|---|---|
| 秒 | 是 | 0-59 | , - * / |
| 分 | 是 | 0-59 | , - * / |
| 時 | 是 | 0-23 | , - * / |
| 日 | 是 | 1-31 | , - * ? / L W C |
| 月 | 是 | 1-12 或 JAN-DEC | , - * / |
| 周 | 是 | 1-7 或 SUN-SAT | , - * ? / L C # |
| 年 | 否 | 空 或 1970-2099 | , - * / |
注意在cron表達式中不區分大小寫.
星號(*)：可用在所有字段中，表示對應時間域的每一個時刻，例如， 在分鍾字段時，表示“每分鍾”；
問號（?）：該字符只在日期和星期字段中使用，它通常指定為“無意義的值”，相當於點位符；
減號(-)：表達一個范圍，如在小時字段中使用“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出現在星期字段里，而且在前面有一個數值X，則表示“這個月的最后X天”，例如，6L表示該月的最后星期五；
W：該字符只能出現在日期字段里，是對前導日期的修飾，表示離該日期最近的工作日。例如15W表示離該月15號最近的工作日，如果該月15號是星期六，則匹配14號星期五；如果15日是星期日，則匹配16號星期一；如果15號是星期二，那結果就是15號星期二。但必須注意關聯的匹配日期不能夠跨月，如你指定1W，如果1號是星期六，結果匹配的是3號星期一，而非上個月最后的那天。W字符串只能指定單一日期，而不能指定日期范圍；
LW組合：在日期字段可以組合使用LW，它的意思是當月的最后一個工作日；
井號(#)：該字符只能在星期字段中使用，表示當月某個工作日。如6#3表示當月的第三個星期五(6表示星期五，#3表示當前的第三個)，而4#5表示當月的第五個星期三，假設當月沒有第五個星期三，忽略不觸發；
C：該字符只在日期和星期字段中使用，代表“Calendar”的意思。它的意思是計划所關聯的日期，如果日期沒有被關聯，則相當於日歷中所有日期。例如5C在日期字段中就相當於日歷5日以后的第一天。1C在星期字段中相當於星期日后的第一天。
Cron表達式對特殊字符的大小寫不敏感，對代表星期的縮寫英文大小寫也不敏感。
2.官方的一些案例
| 表示式 | 說明 |
|---|---|
| 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分運行。 |
以上就可以實現大部分的業務的需求了，以下是對Quartz的API的一些了解
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
六、Quartz的三個基本要素
Quartz對任務調度的領域問題進行了高度的抽象，提出了調度器、任務和觸發器這3個核心的概念，並在org.quartz通過接口和類對重要的這些核心概念進行描述：
●Job：是一個接口，只有一個方法void execute(JobExecutionContext context)，開發者實現該接口定義運行任務，JobExecutionContext類提供了調度上下文的各種信息。Job運行時的信息保存在JobDataMap實例中；
●JobDetail：Quartz在每次執行Job時，都重新創建一個Job實例，所以它不直接接受一個Job的實例，相反它接收一個Job實現類，以便運行時通過newInstance()的反射機制實例化Job。因此需要通過一個類來描述Job的實現類及其它相關的靜態信息，如Job名字、描述、關聯監聽器等信息，JobDetail承擔了這一角色。
通過該類的構造函數可以更具體地了解它的功用：JobDetail(java.lang.String name, java.lang.String group, java.lang.Class jobClass)，該構造函數要求指定Job的實現類，以及任務在Scheduler中的組名和Job名稱；
●Trigger：是一個類，描述觸發Job執行的時間觸發規則。主要有SimpleTrigger和CronTrigger這兩個子類。當僅需觸發一次或者以固定時間間隔周期執行，SimpleTrigger是最適合的選擇；而CronTrigger則可以通過Cron表達式定義出各種復雜時間規則的調度方案：如每早晨9:00執行，周一、周三、周五下午5:00執行等；
●Calendar：org.quartz.Calendar和java.util.Calendar不同，它是一些日歷特定時間點的集合（可以簡單地將org.quartz.Calendar看作java.util.Calendar的集合——java.util.Calendar代表一個日歷時間點，無特殊說明后面的Calendar即指org.quartz.Calendar）。一個Trigger可以和多個Calendar關聯，以便排除或包含某些時間點。
假設，我們安排每周星期一早上10:00執行任務，但是如果碰到法定的節日，任務則不執行，這時就需要在Trigger觸發機制的基礎上使用Calendar進行定點排除。針對不同時間段類型，Quartz在org.quartz.impl.calendar包下提供了若干個Calendar的實現類，如AnnualCalendar、MonthlyCalendar、WeeklyCalendar分別針對每年、每月和每周進行定義；
●Scheduler：代表一個Quartz的獨立運行容器，Trigger和JobDetail可以注冊到Scheduler中，兩者在Scheduler中擁有各自的組及名稱，組及名稱是Scheduler查找定位容器中某一對象的依據，Trigger的組及名稱必須唯一，JobDetail的組和名稱也必須唯一（但可以和Trigger的組和名稱相同，因為它們是不同類型的）。Scheduler定義了多個接口方法，允許外部通過組及名稱訪問和控制容器中Trigger和JobDetail。
Scheduler可以將Trigger綁定到某一JobDetail中，這樣當Trigger觸發時，對應的Job就被執行。一個Job可以對應多個Trigger，但一個Trigger只能對應一個Job。可以通過SchedulerFactory創建一個Scheduler實例。Scheduler擁有一個SchedulerContext，它類似於ServletContext，保存着Scheduler上下文信息，Job和Trigger都可以訪問SchedulerContext內的信息。SchedulerContext內部通過一個Map，以鍵值對的方式維護這些上下文數據，SchedulerContext為保存和獲取數據提供了多個put()和getXxx()的方法。可以通過Scheduler# getContext()獲取對應的SchedulerContext實例；
●ThreadPool：Scheduler使用一個線程池作為任務運行的基礎設施，任務通過共享線程池中的線程提高運行效率。
Job有一個StatefulJob子接口，代表有狀態的任務，該接口是一個沒有方法的標簽接口，其目的是讓Quartz知道任務的類型，以便采用不同的執行方案。無狀態任務在執行時擁有自己的JobDataMap拷貝，對JobDataMap的更改不會影響下次的執行。而有狀態任務共享共享同一個JobDataMap實例，每次任務執行對JobDataMap所做的更改會保存下來，后面的執行可以看到這個更改，也即每次執行任務后都會對后面的執行發生影響。
正因為這個原因，無狀態的Job可以並發執行，而有狀態的StatefulJob不能並發執行，這意味着如果前次的StatefulJob還沒有執行完畢，下一次的任務將阻塞等待，直到前次任務執行完畢。有狀態任務比無狀態任務需要考慮更多的因素，程序往往擁有更高的復雜度，因此除非必要，應該盡量使用無狀態的Job。
如果Quartz使用了數據庫持久化任務調度信息，無狀態的JobDataMap僅會在Scheduler注冊任務時保持一次，而有狀態任務對應的JobDataMap在每次執行任務后都會進行保存。
Trigger自身也可以擁有一個JobDataMap，其關聯的Job可以通過JobExecutionContext#getTrigger().getJobDataMap()獲取Trigger中的JobDataMap。不管是有狀態還是無狀態的任務，在任務執行期間對Trigger的JobDataMap所做的更改都不會進行持久，也即不會對下次的執行產生影響。
Quartz擁有完善的事件和監聽體系，大部分組件都擁有事件，如任務執行前事件、任務執行后事件、觸發器觸發前事件、觸發后事件、調度器開始事件、關閉事件等等，可以注冊相應的監聽器處理感興趣的事件。
七、Quartz的3大API之一 - Job
1.JobDetail & Job和JobDataMap
JobDetail是任務的定義，而Job是任務的執行邏輯。在JobDetail里會引用一個Job Class定義。
每一個JobDetail都會有一個JobDataMap。JobDataMap本質就是一個Map的擴展類，只是提供了一些更便捷的方法，比如getString()之類的。
還是老樣子，編寫兩個類來看效果。
2.編寫觸發類 CronScheduler.java
public class HelloScheduler { public static void main(String[] args) throws SchedulerException { //1.創建一個jobDetail的實例，將該實例與HelloJob Class綁定 JobDetail jobDetail = JobBuilder .newJob(HelloJob.class) //定義Job類為HelloJob類，真正的執行邏輯所在 .withIdentity("myJob", "group1") //定義name 和 group .usingJobData("message","hello myJob1") //加入屬性到jobDataMap .usingJobData("FloatJobValue",8.88f) //加入屬性到jobDataMap .build(); //2.創建一個Trigger觸發器的實例，定義該job立即執行，並且每2秒執行一次，一直執行 SimpleTrigger trigger = TriggerBuilder.newTrigger() .withIdentity("myTrigger", "group1") .startNow() .withSchedule(SimpleScheduleBuilder.simpleSchedule().withIntervalInSeconds(2).repeatForever()) .build(); //3.創建schedule實例 StdSchedulerFactory factory = new StdSchedulerFactory(); Scheduler scheduler = factory.getScheduler(); scheduler.start(); //啟動 scheduler.scheduleJob(jobDetail,trigger); // jobDetail和trigger加入調度 } }
3.編寫具體任務類HelloJob.java,並打印值
public class HelloJob implements Job{ public void execute(JobExecutionContext jobExecutionContext) throws JobExecutionException { //打印當前的執行時間 例如 2017-11-22 00:00:00 Date date = new Date(); SimpleDateFormat sf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); System.out.println("現在的時間是："+ sf.format(date)); //具體的業務邏輯 System.out.println("開始生成任務報表 或 開始發送郵件...."); JobKey key = jobExecutionContext.getJobDetail().getKey(); System.out.println("jobDetail 的name ： "+key.getName()); //打印jobDetail 的name System.out.println("jobDetail 的group ： "+key.getGroup()); //打印jobDetail 的group JobDataMap jobDetailDataMap = jobExecutionContext.getJobDetail().getJobDataMap(); String message = jobDetailDataMap.getString("message"); // float floatJobValue = jobDetailDataMap.getFloat("FloatJobValue"); System.out.println("jobDataMap定義的message的值 : "+message ); //打印jobDataMap定義的message的值 System.out.println("jobDataMap定義的floatJobValue的值 : "+floatJobValue ); //jobDataMap定義的floatJobValue的值 } }
4.實現的效果
5.通過get、Set方式獲取dataMap中的值 （修改一下HelloJob.java）即可
public class HelloJob implements Job{ //這里是第二種獲取jobDataMap中的值的方法 private String message; private Float floatJobValue; private Double doubleTriggerValue; public String getMessage() { return message; } public void setMessage(String message) { this.message = message; } public Float getFloatJobValue() { return floatJobValue; } public void setFloatJobValue(Float floatJobValue) { this.floatJobValue = floatJobValue; } public Double getDoubleTriggerValue() { return doubleTriggerValue; } public void setDoubleTriggerValue(Double doubleTriggerValue) { this.doubleTriggerValue = doubleTriggerValue; } public void execute(JobExecutionContext jobExecutionContext) throws JobExecutionException { //打印當前的執行時間 例如 2017-11-22 00:00:00 Date date = new Date(); SimpleDateFormat sf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); System.out.println("現在的時間是："+ sf.format(date)); System.out.println("jobDataMap定義的message的值 : "+message ); //打印jobDataMap定義的message的值 System.out.println("jobDataMap定義的floatJobValue的值 : "+floatJobValue ); //jobDataMap定義的floatJobValue的值 } }
6.效果如下
八、Quartz的3大API之一 - Tigger
1.startTime和endTime
有時候我們希望一個定時任務在一定的時間內是每天執行，比如2017年11月24日到2017年12月15日之間執行，這時候我們就要使用startTime和endTime來限定事件范圍了。例子中我們把時間規定在幾秒鍾之內運行，方便查看效果。
1.1編寫Scheduler類SecondScheduler.java
public class SecondScheduler { public static void main(String[] args) throws SchedulerException { //創建一個JobDetail的實例，將該實例與HelloJob綁定 JobDetail jobDetail = JobBuilder.newJob(HelloJob.class).withIdentity("zhlJob").build(); //開始時間 3秒鍾之后 （具體時間按實際業務編寫） Date sData = new Date(); sData.setTime(sData.getTime()+3000); //結束時間 6秒鍾之后 （具體時間按實際業務編寫） Date eData = new Date(); eData.setTime(eData.getTime()+6000); //創建一個Trigger實例，定義該job3秒之后執行，在6秒之后結束 SimpleTrigger zhlTrigger = TriggerBuilder.newTrigger().withIdentity("zhlTrigger") .startAt(sData) //設定開始時間 .endAt(eData) //設定結束時間 .withSchedule(SimpleScheduleBuilder.simpleSchedule().withIntervalInSeconds(2).repeatForever()) //每兩秒打印一次 .build(); //創建Scheduler實例 StdSchedulerFactory stdSchedulerFactory = new StdSchedulerFactory(); Scheduler scheduler = stdSchedulerFactory.getScheduler(); scheduler.start(); scheduler.scheduleJob(jobDetail,zhlTrigger); } }
1.2編寫job類
public class HelloJob implements Job{public void execute(JobExecutionContext jobExecutionContext) throws JobExecutionException { //打印當前的執行時間 例如 2017-11-22 00:00:00 Date date = new Date(); SimpleDateFormat sf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); System.out.println("現在的時間是："+ sf.format(date)); //具體的業務邏輯 System.out.println("具體執行的業務..."); JobKey key = jobExecutionContext.getJobDetail().getKey(); Trigger trigger = jobExecutionContext.getTrigger(); System.out.println("開始的時間： "+sf.format(trigger.getStartTime())); //打印開始時間 System.out.println("結束的事件： "+sf.format(trigger.getEndTime())); //打印結束時間 } }
1.3打印效果
2.BaseCalndar
此calendar不是java.util.Calendar，calendar是為了補充Trigger的時間，可以拍除了或加入一下特定的時間。Quartz 的 Calender 專門用於屏閉一個時間區間，使 Trigger 在這個區間中不被觸發。
2.1Quartz 包含了你的應用可用的許多的 Calender 類型
- AnnualCalendar:排除每一年中指定的一天或者多少天 ，精度是天
- CronCalendar:使用表達式排除某些時間段不執行，精度取決於Cron表達式，最大精度到秒
- DailyCalendar：指定的時間范圍內的每一天不執行，指定每天的時間段，格式是HH:MM[:SS[:mmm]]。也就是最大精度可以到毫秒。
- HolidayCalendar：排除節假日，精度到天
- MonthlyCalendar：排除月份中的數天，可選值為1-31。精度是天
- WeeklyCalendar：排除星期中的一天或多天，可選值比如為java.util.Calendar.SUNDAY，精度是天。
下面以AnnualCalendar舉例，來實現某一天不執行程序。
2.2編寫Scheduler類CalendarSchedule.java
public class CalendarSchedule { public static void main(String[] args) throws SchedulerException { SimpleDateFormat sf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); //創建一個JobDetail的實例，將該實例與HelloJob綁定 JobDetail jobDetail = JobBuilder.newJob(HelloJob.class).withIdentity("zhlJob").build(); AnnualCalendar holidays = new AnnualCalendar(); GregorianCalendar nationalDay = new GregorianCalendar(2017, 10, 27); // 排除今天的時間2017年11月27日（月份是從0～11的） holidays.setDayExcluded(nationalDay,true); //排除的日期，如果為false則為包含*/ //創建Scheduler實例 StdSchedulerFactory stdSchedulerFactory = new StdSchedulerFactory(); Scheduler scheduler = stdSchedulerFactory.getScheduler(); //向Scheduler注冊日歷 scheduler.addCalendar("holidays",holidays,false,false); Trigger simpleTrigger = TriggerBuilder.newTrigger() .withIdentity("zhlTrigger") .withSchedule(SimpleScheduleBuilder.simpleSchedule().withIntervalInSeconds(1).repeatForever()) //每一秒執行一次job .modifiedByCalendar("holidays") //將我們設置好的Calander與trigger綁定 .build(); //讓trigger應用指定的日歷規則 //scheduler.scheduleJob(jobDetail,simpleTrigger); System.out.println("現在的時間 ："+sf.format(new Date())); System.out.println("最近的一次執行時間 ："+sf.format(scheduler.scheduleJob(jobDetail,simpleTrigger))); //scheduler與jobDetail、trigger綁定，並打印出最近一次執行的事件 scheduler.start(); } }
2.3編寫job類 ，仍然使用HelloJob就可以
public class HelloJob implements Job{public void execute(JobExecutionContext jobExecutionContext) throws JobExecutionException { //打印當前的執行時間 例如 2017-11-22 00:00:00 Date date = new Date(); SimpleDateFormat sf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); System.out.println("現在的時間是："+ sf.format(date)); //具體的業務邏輯 System.out.println("具體執行的業務..."); Trigger trigger = jobExecutionContext.getTrigger(); System.out.println("開始的時間： "+sf.format(trigger.getStartTime())); //打印開始時間 System.out.println("結束的事件： "+sf.format(trigger.getEndTime())); //打印結束時間 }
2.4執行后的效果
可以發現，我將程序設置為2017年11月27日也就是今天不執行，並打印出了程序最近的一次的執行時間，是明天。由此可見，排除時間成功。
3.Trigger的實現類
SimpleTrigger和CronTrigger之前已經介紹過了，接下來介紹一下CalendarIntervalTrigger 和 DailyTimeIntervalTrigger
1.CalendarIntervalTrigger
CalendarIntervalTrigger：是一個具體的Trigger，用來觸發基於定時重復的JobDetail。
Trigger將會每隔N個calendar在trigger中定義的時間單元觸發一次。這個trigger不適合使用SimpleTrigger完成(例如由於每一個月的時間不是固定的描述)，也不適用於CronTrigger(例如每5個月)。
相較於SimpleTrigger有兩個優勢：1、更方便，比如每隔1小時執行，你不用自己去計算1小時等於多少毫秒。 2、支持不是固定長度的間隔，比如間隔為月和年。但劣勢是精度只能到秒。
它適合的任務類似於：9:00 開始執行，並且以后每周 9:00 執行一次
它的屬性有:
-
interval 執行間隔
-
intervalUnit 執行間隔的單位（秒，分鍾，小時，天，月，年，星期）
例子：
CalendarIntervalScheduleBuilder .calendarIntervalSchedule() .withIntervalInDays(1) //每天執行一次 //.withIntervalInHours(1) //.withIntervalInMinutes(1) //.withIntervalInMonths(1) //.withIntervalInSeconds(1) //.withIntervalInWeeks(1) //.withIntervalInHours(1) .build()
2.DailyTimeIntervalTrigger
指定每天的某個時間段內，以一定的時間間隔執行任務。並且它可以支持指定星期。
它適合的任務類似於：指定每天9:00 至 18:00 ，每隔70秒執行一次，並且只要周一至周五執行。
它的屬性有:
- startTimeOfDay 每天開始時間
- endTimeOfDay 每天結束時間
- daysOfWeek 需要執行的星期
- interval 執行間隔
- intervalUnit 執行間隔的單位（秒，分鍾，小時，天，月，年，星期）
- repeatCount 重復次數
2.1編寫Scheduler類
public static void main(String[] args) throws SchedulerException { SimpleDateFormat sf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); //1.創建一個jobDetail的實例，將該實例與HelloJob Class綁定 JobDetail jobDetail = JobBuilder .newJob(HelloJob.class) .withIdentity("myJob", "group1") //定義name 和 group .build(); //2.創建一個Trigger觸發器的實例 Trigger simpleTrigger = TriggerBuilder.newTrigger() .withIdentity("zhlTrigger") .withSchedule( DailyTimeIntervalScheduleBuilder.dailyTimeIntervalSchedule() .startingDailyAt(TimeOfDay.hourAndMinuteOfDay(8, 0)) //每天8：00開始 .endingDailyAt(TimeOfDay.hourAndMinuteOfDay(17, 0)) //17：00 結束 .onDaysOfTheWeek(MONDAY,TUESDAY,WEDNESDAY,THURSDAY,FRIDAY) //周一至周五執行 .withIntervalInHours(1) //每間隔1小時執行一次 .withRepeatCount(100) //最多重復100次（實際執行100+1次） ) .modifiedByCalendar("holidays") //將我們設置好的Calander與trigger綁定 .build(); //3.創建schedule實例 StdSchedulerFactory factory = new StdSchedulerFactory(); Scheduler scheduler = factory.getScheduler(); System.out.println("現在的時間 ："+sf.format(new Date())); System.out.println(); System.out.println("最近的一次執行時間 ："+sf.format(scheduler.scheduleJob(jobDetail,simpleTrigger))); //scheduler與jobDetail、trigger綁定，並打印出最近一次執行的事件 scheduler.start(); }
2.2打印的效果
九、總結：
雖然介紹了Quartz一些基本的用法，但是Quartz的強大不止這些，包括集成Spring，與Spring Boot的集成，quartz的listener，quartz的持久化，集群，插件等等，之后會陸續的介紹。最后，quartz是一個基於java的非常成熟的任務調度框架，適合於任何常規的使用，以及個性化的開發使用， 其次通過數據庫的持久化，可以選擇實現集群，大大增加了任務調度的可靠性，值得每個程序人借鑒使用。