Quartz.NET是一個開源的作業排程框架(轉自張善友部落格)

yuan_jie發表於2012-12-14

Quartz.NET是一個開源的作業排程框架,是OpenSymphony  Quartz API.NET移植,它用C#寫成,可用於winformasp.net應用中。它提供了巨大的靈活性而不犧牲簡單性。你能夠用它來為執行一個作業而建立簡單的或複雜的排程。它有很多特徵,如:資料庫支援,叢集,外掛,支援cron-like表示式等等。  
      你曾經需要應用執行一個任務嗎?這個任務每天或每週星期二晚上1130,或許僅僅每個月的最後一天執行。一個自動執行而無須干預的任務在執行過程中如果發生一個嚴重錯誤,應用能夠知到其執行失敗並嘗試重新執行嗎?你和你的團隊是用.NET程式設計嗎?如果這些問題中任何一個你回答是,那麼你應該使用Quartz.NET排程器。 Quartz.NET
允許開發人員根據時間間隔(或天)來排程作業。它實現了作業和觸發器的多對多關係,還能把多個作業與不同的觸發器關聯。整合了 Quartz.NET的應用程式可以重用來自不同事件的作業,還可以為一個事件組合多個作業.
   
   下面是官方的開發指南教程的中文版:英文版的參照官方網站(
http://quartznet.sourceforge.net/tutorial.html
  

 

Quartz.net官方開發指南 第一課:使用Quartz.net

 

    使用scheduler之前應首先例項化它。使用SchedulerFactory可以完成scheduler的例項化

 

Quartz.net官方開發指南 第二課:Jobs And Triggers

 

   JobDetail物件由Quartz客戶端在Job被加入到scheduler時建立。它包含了Job的各種設定屬性以及一個JobDataMap物件,這個物件被用來儲存給定Job類例項的狀態資訊。 
Trigger
物件被用來觸發jobs的執行。你希望將任務納入到進度,要例項化一個Trigger並且調整它的屬性以滿足你想要的進度安排。Triggers也有一個JobDataMap與之關聯,這非常有利於向觸發器所觸發的Job傳遞引數。Quartz打包了很多不同型別的Trigger,但最常用的Trigge類是SimpleTriggerCronTrigger

 

Quartz.net官方開發指南 第三課:更多關於Jobs和JobDetails

 

  在所實現的類成為真正的“Job”時,期望任務所具有的各種屬性需要通知給Quartz。通過JobDetail類可以完成這個工作,這個類在前面的章節中曾簡短提及過。現在,我們花一些時間來討論QuartzJobs的本質和Job例項的生命週期。

 

Quartz.net方開發指南 第四課:關於Triggers更多內容

 

     Job一樣,trigger非常容易使用,但它有一些可選項需要注意和理解,同時,trigger有不同的型別,要按照需求進行選擇  
Quartz.net官方開發指南 第五課: SimpleTrigger

 

   如果需要讓任務只在某個時刻執行一次,或者,在某個時刻開始,然後按照某個時間間隔重複執行,簡單地說,如果你想讓觸發器在2007820日上午112354秒執行,然後每個隔10秒鐘重複執行一次,並且這樣重複5次。那麼SimpleTrigger 就可以滿足你的要求。

 

Quartz.net官方開發指南 第六課 : CronTrigger

 

    如果你需要像日曆那樣按日程來觸發任務,而不是像SimpleTrigger 那樣每隔特定的間隔時間觸發,CronTriggers通常比SimpleTrigger更有用。 
使用CronTrigger,你可以指定諸如每個週五中午,或者每個工作日的9:30”或者從每個週一、週三、週五的上午900到上午1000之間每隔五分鐘這樣日程安排來觸發。甚至,象SimpleTrigger一樣,CronTrigger也有一個StartTime以指定日程從什麼時候開始,也有一個(可選的)EndTime以指定何時日程不再繼續。

 

Quartz.net官方開發指南 第七課 : TriggerListeners和JobListeners

 

   監聽器是在scheduler事件發生時能夠執行動作的物件。可以看出,TriggerListeners接收與triggers相關的事件,而JobListeners則接收與Job相關的事件。 

 

Quartz.net官方開發指南 第八課:SchedulerListeners

 

  SchedulerListenersTriggerListenersJobListeners非常相似,SchedulerListeners只接收與特定trigger job無關的Scheduler自身事件通知。 
Scheduler
相關的事件包括:增加job或者trigger,移除Job或者trigger, scheduler內部發生的錯誤,scheduler將被關閉的通知,以及其他。

 

Quartz.net官方開發指南 第九課: JobStore

 

    JobStore負責保持對所有scheduler “工作資料追蹤,這些工作資料包括:job(任務),trigger(觸發器),calendar(日曆)等。為你的Quartz scheduler選擇合適的JobStore是非常重要的一步,幸運的是,如果你理解了不同的JobStore之間的差別,那麼選擇就變得非常簡單。在提供產生scheduler 例項的SchedulerFactory的屬性檔案中宣告scheduler所使用的JobStore(以及它的配置)

 

Quartz.net官方開發指南 第十課: 配置、資源使用以及SchedulerFactory

 

    Quartz以模組方式構架,因此,要使它執行,幾個元件必須很好的咬合在一起。幸運的是,已經有了一些現存的助手可以完成這些工作   

 

Quartz.net官方開發指南 第十一課: 高階(企業級)屬性

 

   叢集只能用在使用ADO.NET-Jobstore的情況。特新包括負載均衡和容錯(如果JobDetail"request recovery"標記被設定為true 

 

Quartz.net官方開發指南 第十二課:Quartz 的其他特性

 

  Plug-Ins 外掛 :Quartz提供了一個介面(ISchedulerPlugin)來插入附加的功能。 
  JobFactory 
:當觸發器觸發時,與之相關聯的任務被Scheduler中配置的JobFactory所例項華。預設的JobFactory只是簡單地建立一個Job例項。你也許想建立自己的JobFactory實現,以完成諸如讓應用的IoC或者 DI容器產生/初始化job例項的功能。
 
'Factory-Shipped' Jobs 
Quartz也提供了一些可以在你的應用中使用的實用的Jobs,比如,發郵件、呼叫遠端物件。這些外來的Job可以在Quartz.Jobs名稱空間裡中找到。

 

 

 

 

 


Cron表示式

Quartz使用類似於Linux下的Cron表示式定義時間規則,Cron表示式由6或7個由空格分隔的時間欄位組成。

 

表1 Cron表示式時間欄位 

時間域名              允許值                      允許的特殊字元

1      秒                   0-59                           , - * /

2     分鐘                  0-59                           , - * /

3     小時                  0-23                           , - * /

4     日期                  1-31                           , - * ? / L W C

5     月份                  1-12                           , - * /

6     星期                  1-7                            , - * ? / L C #

7    年(可選)              空值 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下面給出一些完整的Cron表示式的例項: 

"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分執行。

 

其中:不用設定的用”?”.
(1)每月第幾天和每星期第幾天是互斥的,兩個只能設定1個。如果有好幾個時間點,可以使用”,”符號,例如:”0 0 10,12,14 * * ?”表示每天的10時,12時,14時執行Job. 
(2)
對於連續時間可以使用”-”符號。例如:”0 10,12,14 1-15 * ?”表示每月的1到15日10時,12時,14時執行Job. 
(3)
時間格式的年可以不用制定。例如”0 0 10,12,14 ? MON 2006”表示2006年每星期一的10時,12時,14時執行Job. 

 

 

相關文章