CronTriggers使用的頻率比SimpleTrigger跟高。如果需要schedule?中觸發Job的方式類似于日歷的形式而不是一個確定的是時間間隔，那就需要使用CronTrigger。

?

對于CronTrigger，你可以觸發Schedule，例如每個周五中午或者每個工作日的下午9:30或者在早上9:00至10：；之間每五分鐘執行一次在每個周一、周二、周五執行。

?

不緊如此，SampleTrigger和CronTriggerd都有一個啟動時間和一個可選的結束時間來停止。

Cron Expressions

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

Seconds

Minutes

Hours

Day-of-Month

Month

Day-of-Week

Year (optional field

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

?

個別的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.表示。

?

‘/’用來表示一個特殊的增長間隔。例如在Minutes字段上寫入0/15，表示的意思是每15執行，在0分鐘的時候啟動。如果寫的3/20則表示每20分鐘執行一次，在3分鐘鐘后啟動，其工作的時間是3,23,43.

?

‘?’可以用在?day-of-month and day-of-week字段上面。用來表示沒有具體值得意思。如果你需要在這兩個字段做一些特殊的操作這個符號是非常有用的，詳情請看CronTrigger API documentation。

?

‘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。

?

1、每五分鐘執行一次

"0 0/5 * * * ?"

?

2、每五分鐘執行一次，十秒等待

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

?

3、每周一和周五的10:30 11:30 12:30 13:30執行一次

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

?

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

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

?

注意：有些觸發機制過于復雜，例如每五分鐘執行一次在每月的8-9點，并且在13至22點沒20分鐘執行一次，對于這樣的觸發記住，可以裝件兩個單獨的觸發器來工作相同的內容。

?

Building CronTriggers

構建CronTrigger具體實例，使用的是TriggerBuilder?（用來配置Trigger主要的內容）和WithCronSchedule（用來配置Trigger的特殊需要內容）?擴展方法。

?

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

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

2、構建一個每天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();

3、構建一個每個星期二的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();

?

?

轉載于:https://www.cnblogs.com/gsjlovenet/p/5912466.html

總結

以上是生活随笔為你收集整理的Quartz 第六课 CronTrigger（官方文档翻译）的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。