Quartz.Net進(jìn)階之二：關(guān)于觸發(fā)器的更多信息 原文:Quartz.Net進(jìn)階之二：關(guān)于觸發(fā)器的更多信息

?? ???? 與作業(yè)一樣，觸發(fā)器相對(duì)容易使用，但是在您可以充分利用Quartz.NET之前，確實(shí)需要了解和理解各種可自定義的選項(xiàng)。 此外，如前所述，您可以選擇不同類型的觸發(fā)器來滿足不同的調(diào)度需求。

?? ?1、常見觸發(fā)器屬性（Common Trigger Attributes）

?? ??? ?除了所有觸發(fā)器類型都具有用于跟蹤其身份的TriggerKey屬性之外，還有許多其他屬性對(duì)所有觸發(fā)器類型都是通用的。 在構(gòu)建觸發(fā)器定義時(shí)，使用TriggerBuilder設(shè)置這些常用屬性（后面將舉例說明）。

?? ??? ?以下是所有觸發(fā)器類型共有的屬性列表：

?? ??? ???? 1）、JobKey 屬性指示觸發(fā)器觸發(fā)時(shí)應(yīng)該執(zhí)行作業(yè)的標(biāo)識(shí)。

?? ??? ???? 2）、StartTimeUtc 屬性指示觸發(fā)器的計(jì)劃首次生效是什么時(shí)候。該值是DateTimeOffset對(duì)象，用于定義給定日歷日期的時(shí)刻。對(duì)于某些觸發(fā)器類型，觸發(fā)器實(shí)際上會(huì)在開始時(shí)觸發(fā)，對(duì)于其他觸發(fā)器類型，它只是標(biāo)記應(yīng)該開始遵循調(diào)度的時(shí)間。這意味著您可以存儲(chǔ)一個(gè)觸發(fā)器，其中包含一個(gè)計(jì)劃，例如1月份的“每月的第5天”，如果StartTimeUtc屬性設(shè)置為4月1日，則會(huì)在第一次觸發(fā)前幾個(gè)月。

?? ??? ???? 3）、EndTimeUtc 屬性指示觸發(fā)器的調(diào)度計(jì)劃何時(shí)不再有效。換句話說，具有“每月的第5天”和7月1日結(jié)束時(shí)間表的觸發(fā)器將在6月5日的最后一次觸發(fā)后將結(jié)束。

?? ??? ?其他的屬性需要更多時(shí)間來解釋，將在以下小節(jié)中討論。


?? ?2、優(yōu)先級(jí)
?? ?
?? ??? ?有時(shí)，當(dāng)您有許多觸發(fā)器（或Quartz.NET線程池中的工作線程比較少）時(shí)，Quartz.NET可能沒有足夠的資源來立即觸發(fā)計(jì)劃中該同時(shí)觸發(fā)的所有觸發(fā)器。 在這種情況下，您可能希望控制哪些觸發(fā)器在可用的Quartz.NET工作線程中首先觸發(fā)。為此，您可以在Trigger上設(shè)置priority屬性。 如果同時(shí)觸發(fā)N個(gè)觸發(fā)器，但是當(dāng)前只有Z個(gè)工作線程可用，則首先執(zhí)行具有最高優(yōu)先級(jí)的第一個(gè)Z觸發(fā)器。如果未在觸發(fā)器上設(shè)置優(yōu)先級(jí)，則它將使用默認(rèn)優(yōu)先級(jí)5，優(yōu)先級(jí)的值可以是任何整數(shù)值，包括正數(shù)或者負(fù)數(shù)。

?? ??? ?注意：優(yōu)先級(jí)僅在觸發(fā)器具有相同的激活時(shí)間時(shí)才進(jìn)行比較。定于10:59激活的觸發(fā)器總是在定于11:00激活的觸發(fā)器之前開火。

?? ??? ?注意：當(dāng)檢測(cè)到觸發(fā)器的作業(yè)需要恢復(fù)時(shí)，其恢復(fù)的調(diào)度優(yōu)先級(jí)與原始觸發(fā)器相同。


?? ?3、Misfire Instructions

?? ??? ?觸發(fā)器的另一個(gè)重要特性是它的“失火指令”。 如果持久性觸發(fā)器由于調(diào)度程序被關(guān)閉而“錯(cuò)過”其觸發(fā)時(shí)間，或者因?yàn)镼uartz.NET的線程池中沒有可用于執(zhí)行作業(yè)的線程，則會(huì)發(fā)生失敗。 不同的觸發(fā)類型可以使用不同的失火指令。 默認(rèn)情況下，它們使用“智能策略”指令 - 該指令具有基于觸發(fā)類型和配置的動(dòng)態(tài)行為。 當(dāng)調(diào)度程序啟動(dòng)時(shí)，它會(huì)搜索任何已失效的持久觸發(fā)器，然后根據(jù)各自配置的失火指令更新每個(gè)觸發(fā)器。 當(dāng)您在自己的項(xiàng)目中開始使用Quartz.NET時(shí)，您應(yīng)該熟悉在給定觸發(fā)器類型上定義的失火指令，并在其API文檔中進(jìn)行了解釋。 有關(guān)失火指令的更多具體信息將在特定于每種觸發(fā)類型的教程課程中給出。

?? ?4、Calendars

?? ??? ?實(shí)現(xiàn)ICalendar接口的Quartz.NET Calendar對(duì)象可以在觸發(fā)器存儲(chǔ)在調(diào)度程序中時(shí)與觸發(fā)器相關(guān)聯(lián)。 日歷可用于從觸發(fā)器的觸發(fā)計(jì)劃中排除時(shí)間塊。 例如，您可以創(chuàng)建一個(gè)觸發(fā)器，在每個(gè)工作日上午9:30觸發(fā)作業(yè)，但隨后添加一個(gè)排除所有業(yè)務(wù)假期的日歷。

?? ??? ?Calendar可以是任何實(shí)現(xiàn)ICalendar接口的可序列化對(duì)象，如下所示：

1 namespace Quartz 2 { 3 public interface ICalendar 4 { 5 string Description { get; set; } 6 7 ICalendar CalendarBase { set; get; } 8 9 bool IsTimeIncluded(DateTimeOffset timeUtc); 10 11 DateTime GetNextIncludedTimeUtc(DateTimeOffset timeUtc); 12 13 ICalendar Clone(); 14 } 15 }

?? ??? ?盡管日歷對(duì)象可以“阻擋”只有一毫秒那么短的時(shí)間段，但很可能，你會(huì)對(duì)“封鎖”整天的時(shí)間感興趣。 為方便起見，Quartz.NET包含了類HolidayCalendar，它就是這樣做的。

?? ??? ?必須實(shí)例化日歷對(duì)象，并通過AddCalendar(..)方法向調(diào)度程序注冊(cè)日歷對(duì)象。如果使用HolidayCalendar，則在實(shí)例化它之后，應(yīng)該使用它的AddExcludedDate(DateTime日期)方法，可以將從調(diào)度中排除的天數(shù)做參數(shù)傳遞給該方法。同一個(gè)日歷實(shí)例可以與多個(gè)觸發(fā)器一起使用，例如：

1 HolidayCalendar cal = new HolidayCalendar(); 2 cal.AddExcludedDate(someDate); 3 4 await sched.AddCalendar("myHolidays", cal, false); 5 6 ITrigger t = TriggerBuilder.Create() 7 .WithIdentity("myTrigger") 8 .ForJob("myJob") 9 .WithSchedule(CronScheduleBuilder.DailyAtHourAndMinute(9, 30)) // execute job daily at 9:30 10 .ModifiedByCalendar("myHolidays") // but not on holidays 11 .Build(); 12 13 // .. schedule job with trigger 14 15 ITrigger t2 = TriggerBuilder.Create() 16 .WithIdentity("myTrigger2") 17 .ForJob("myJob2") 18 .WithSchedule(CronScheduleBuilder.DailyAtHourAndMinute(11, 30)) // execute job daily at 11:30 19 .ModifiedByCalendar("myHolidays") // but not on holidays 20 .Build(); 21 22 // .. schedule job with trigger2

?? ??? ?觸發(fā)器的構(gòu)造/構(gòu)建的細(xì)節(jié)將在接下來的幾篇文章中給出。 現(xiàn)在，只要相信上面的代碼創(chuàng)建了兩個(gè)觸發(fā)器，每個(gè)觸發(fā)器計(jì)劃每天觸發(fā)。 但是，將跳過在日歷排除的期間內(nèi)發(fā)生的任何發(fā)射。

?? ??? ?有關(guān)可能滿足您需求的許多ICalendar實(shí)現(xiàn)，請(qǐng)參閱Quartz.Impl.Calendar命名空間。

posted on 2019-03-27 14:36 NET未來之路 閱讀(...) 評(píng)論(...) 編輯 收藏

轉(zhuǎn)載于:https://www.cnblogs.com/lonelyxmas/p/10607355.html

總結(jié)

以上是生活随笔為你收集整理的Quartz.Net进阶之二：关于触发器的更多信息的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。