Quartz 第六課 CronTrigger(官方文檔翻譯)

CronTriggers使用的頻率比SimpleTrigger跟高。若是須要schedule 中觸發Job的方式相似於日曆的形式而不是一個肯定的是時間間隔,那就須要使用CronTrigger。express

 

對於CronTrigger,你能夠觸發Schedule,例如每一個週五中午或者每一個工做日的下午9:30或者在早上9:00至10:;之間每五分鐘執行一次在每一個周1、周2、週五執行。ui

 

不緊如此,SampleTrigger和CronTriggerd都有一個啓動時間和一個可選的結束時間來中止。spa

Cron Expressions

Cron-Expressions被用於配置CronTrigger實例。Cron-Expressions是一串字符串。由七個部分組成,用來詳細描述時間調度。各個部份內容用空格分開,各部分表示以下:code

  1. Seconds
  2. Minutes
  3. Hours
  4. Day-of-Month
  5. Month
  6. Day-of-Week
  7. Year (optional field

用一個簡單的例子說明:「0 0 12 ? * WED」。這段字符串表達的意思是每一個星期二的12:00.blog

 

個別的sub-expressions能夠包含一個範圍組合。例如:day of week 字段,在以前的例子中能夠寫成「MON-FRI」,「MON,WED,FRI」或者是「MON,WED,SAT」。文檔

 

各部分使用通配符來表示這個字段全部的可能值意思顯而易見在Month字段上表示全部月份,在day of week表示每一個周的全部天數。字符串

 

每一個字段都有本身的值限定。這些限定值得範圍是至關明顯-在分鐘和秒的字段上範圍是0-59。在Hours字段上範圍爲0-23。在day of month 字段上範圍是0-31可是這須要依據具體的月份來計算。Month的有效值爲0-11.。固然也可使用JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV and DEC。day of week 有效範圍是1-7(表示星期日)也可使用SUN, MON, TUE, WED, THU, FRI and SAT.表示。it

 

‘/’用來表示一個特殊的增加間隔。例如在Minutes字段上寫入0/15,表示的意思是每15執行,在0分鐘的時候啓動。若是寫的3/20則表示每20分鐘執行一次,在3分鐘鍾後啓動,其工做的時間是3,23,43.io

 

‘?’能夠用在 day-of-month and day-of-week字段上面。用來表示沒有具體值得意思。若是你須要在這兩個字段作一些特殊的操做這個符號是很是有用的,詳情請看CronTrigger API documentation。class

 

‘L’允許用在day-of-month and day-of-week 字段上面。這個字符在兩個字段上面表示的意思不太同樣。例如:在day-of-month上表示是這個月的最後的一天。若是使用在day-of-week表示的7(SAT)。若是在L前面帶有其它具體值,則表示某個月的最後的某一天。例如6L或者FRIL表示的是該月的最後一個星期5.當你使用L的時候,你須要知道它不會指定一個特殊的具體指或者一個範圍,而是一個不肯定的值。

 

‘W’表示的是最接近給定天的工做日(星期一到星期五)。例如你寫是15W在day-of-month則表示最接近該月15的工做日。

 

「#」被用來指定該月的「第n」XXX工做日。例如,設置值「6#3」或者「FRI#3」在day-of-week,則表示這個月的第三個星期五」。

Example Cron Expressions

下面給出一些具體表達式例子,更具體的介紹見the API documentation for CronTrigger。

 

一、每五分鐘執行一次

"0 0/5 * * * ?"

 

二、每五分鐘執行一次,十秒等待

"10 0/5 * * * ?"   10:00:10  10:05:10

 

三、每週一和週五的10:30 11:30 12:30 13:30執行一次

"0 30 10-13 ? * WED,FRI"

 

四、每個月的5號與20號的8-9點之間每30分鐘執行一次

"0 0/30 8-9 5,20 * ?"

 

注意:有些觸發機制過於複雜,例如每五分鐘執行一次在每個月的8-9點,而且在13至22點沒20分鐘執行一次,對於這樣的觸發記住,能夠裝件兩個單獨的觸發器來工做相同的內容。

 

Building CronTriggers

構建CronTrigger具體實例,使用的是TriggerBuilder (用來配置Trigger主要的內容)和WithCronSchedule(用來配置Trigger的特殊須要內容) 擴展方法。

 

一、建立一個天天的8-17點之間每兩分鐘執行一次

1 trigger = TriggerBuilder.Create()
2     .WithIdentity("trigger3", "group1")
3     .WithCronSchedule("0 0/2 8-17 * * ?")
4     .ForJob("myJob", "group1")
5     .Build();

二、構建一個天天10:42執行一次

1 // we use CronScheduleBuilder's static helper methods here
2 trigger = TriggerBuilder.Create()
3     .WithIdentity("trigger3", "group1")
4     .WithSchedule(CronScheduleBuilder.DailyAtHourAndMinute(10, 42))
5     .ForJob(myJobKey)
6     .Build();

或者

1 trigger = TriggerBuilder.Create()
2     .WithIdentity("trigger3", "group1")
3     .WithCronSchedule("0 42 10 * * ?")
4     .ForJob("myJob", "group1")
5     .Build();

三、構建一個每一個星期二的10:42,使用非系統默認的時區

1 trigger = TriggerBuilder.Create()
2     .WithIdentity("trigger3", "group1")
3     .WithSchedule(CronScheduleBuilder
4         .WeeklyOnDayAndHourAndMinute(DayOfWeek.Wednesday, 10, 42)
5         .InTimeZone(TimeZoneInfo.FindSystemTimeZoneById("Central America Standard Time")))
6     .ForJob(myJobKey)
7     .Build();

或者

1 trigger = TriggerBuilder.Create()
2     .WithIdentity("trigger3", "group1")
3     .WithCronSchedule("0 42 10 ? * WED", x => x
4         .InTimeZone(TimeZoneInfo.FindSystemTimeZoneById("Central America Standard Time")))
5     .ForJob(myJobKey)
6     .Build();

CronTrigger Misfire Instructions

下面的是CronTrigger MisFire(失敗以後執行的策略)。詳情見 API documentation

  • MisfireInstruction.IgnoreMisfirePolicy
  • MisfireInstruction.CronTrigger.DoNothing
  • MisfireInstruction.CronTrigger.FireOnceNow

 

全部觸發器有可以使用的MisfireInstrution.SmartPolicy指令,而且該指令也是全部觸發類型的默認。在「明智的政策」指令被CronTrigger解釋爲MisfireInstruction.CronTrigger.FireOnceNow。對於CronTrigger.UpdateAfterMisfire()方法的API文檔解釋了這種行爲的具體細節。

當創建CronTriggers,您指定的misfire 做爲cron的計劃的一部分(經過WithCronSchedule擴展方法):

1 trigger = TriggerBuilder.Create()
2     .WithIdentity("trigger3", "group1")
3     .WithCronSchedule("0 0/2 8-17 * * ?", x => x
4         .WithMisfireHandlingInstructionFireAndProceed())
5     .ForJob("myJob", "group1")
6     .Build();
相關文章
相關標籤/搜索