1. 程式人生 > >MVC 使用Quartz.Net元件實現定時計劃任務

MVC 使用Quartz.Net元件實現定時計劃任務

   轉載地址

最近,專案中需要執行一個計劃任務,組長就讓我瞭解一下Quartz.net 這個元件,挺簡單的一個元件,實現起來特別的方便,靈活,值得推薦給大家一起學習一下這個小工具。以前我有的時候是使用定時器Timer,還有資料庫中的 計劃任務,後來發現這些真的太不好用了。下面我介紹一下這個元件的使用步驟和注意事項,僅供參考,有什麼不對的地方,希望大家多多見諒並幫我指出來,大家 相互學習嘛。

        首先,簡述一下Quartz.net 元件的基本概念:它是一個簡單的執行任務計劃的元件,基本包括這三部分:Job(作業)、Trigger(觸發器)、scheduler(排程器)。

        1.Job 作業:需要在任務計劃中執行的具體邏輯操作

        2.Trigger 觸發器:需要什麼時間什麼規則來去執行Job 作業

        3.scheduler 排程器 :將Job 和 Trigger 註冊到 scheduler 排程器中,主要負責協調Job、Trigger 的執行

    第一步:下載Quartz.net 元件

      在VS 中 工具 > NuGet 程式包管理器 > 程式包管理控制檯   點選開啟  在控制檯上輸入 Install-Package Quartz  就可以成功下載下來了,詳見如圖所示:

     

第二步:在VS 中我們建立一個類庫,這樣方便我們移植程式,也方便我們程式碼的分離;一個Job 建立一個例項類,下面我會建立兩個例項類一個是UpdateCompleteJob.cs、UpdateAutoCancelStateJob.cs (之所以建立兩個Job是為了能方便大家瞭解這個元件可以同時執行多個任務)

 (1) UpdateCompleteJob.cs 程式碼如下: 

 View Code

(2) UpdateAutoCancelStateJob.cs 程式碼如下:

 View Code

 備註:解釋一下上面兩個類中的方法中的IJobExecutionContext  引數是什麼意思,在Execute方法有一個IJobExecutionContext的介面物件作為引數,這個引數包含了定義這個類的job(作業)的配置資訊。作為例項在這裡我就沒有展示是怎麼使用的,有時間我會補充上去的。

第三步:就該設定Trigger 觸發器,在實際中我是將Trigger和Job 直接註冊到 scheduler 排程器中;在這裡其實還有一小步沒有指出來就是需要將類庫生成的DLL 拷貝到你的需要執行的專案的檔案中.詳見3.1 中的圖

   3.1  下面標紅的是dll 所放檔案的名字,在下面的程式碼中需要使用的,小夥伴們多注意一下

    

具體的程式碼如下:

 View Code

第四步:配置檔案,主要是控制任務執行的時間和Job 的載入

 View Code

備註:下面解析一下配置中重要的幾個屬性 <DllName>WechatMallJobLibrary.dll</DllName> dll的名字 ;jobtype 屬性是dll名字+例項類的名字;expression 這個是設定執行的時間,後續我介紹這個時間的設定

第五步:需要將scheduler 排程器註冊到程式中;在程式中Global.asax.cs 中檔案中添加註冊,在這裡啟動執行任務。

 View Code

OK,上面的就是Quartz.Net 元件執行定時任務的全部流程了,有什麼問題希望大家批評指出;下面就來說明一下設定執行任務的時間的設定:

下面的任務執行時間是參考http://blog.csdn.net/foamflower/article/details/4260645 中的,請詳見

CronTrigger 配置設定格式:

1.格式: [秒] [分] [小時] [日] [月] [周] [年]

   列入:0 0/30 * * * ?  時隔 30 分鐘執行一次

         0/30 * * * * ?   時隔 30 秒執行一次

序號

說明

是否必填 允許填寫的值 允許的萬用字元
1 0-59  , - * /
2 0-59 , - * /
3 小時 0-23 , - * /
4 1-31 , - * ? / L W
5 1-12 or JAN-DEC , - * /
6 1-7 or SUN-SAT , - * ? / L #
7 empty 或 1970-2099 , - * /

2.萬用字元

:表示所有值. 例如:在分的欄位上設定 "*",表示每一分鐘都會觸發。
? :表示不指定值。使用的場景為不需要關心當前設定這個欄位的值。例如:要在每月的10號觸發一個操作,但不關心是周幾,所以需要周位置的那個欄位設定為"?" 具體設定為 0 0 0 10 * ?
- :表示區間。例如 在小時上設定 "10-12",表示 10,11,12點都會觸發。
, :表示指定多個值,例如在周欄位上設定 "MON,WED,FRI" 表示週一,週三和週五觸發
:用於遞增觸發。如在秒上面設定"5/15" 表示從5秒開始,每增15秒觸發(5,20,35,50)。 在月欄位上設定'1/3'所示每月1號開始,每隔三天觸發一次。
L :表示最後的意思。在日欄位設定上,表示當月的最後一天(依據當前月份,如果是二月還會依據是否是潤年[leap]), 在周欄位上表示星期六,相當於"7"或"SAT"。如果在"L"前加上數字,則表示該資料的最後一個。

例如在周欄位上設定"6L"這樣的格式,則表示“本月最後一個星期五"

W :表示離指定日期的最近那個工作日(週一至週五). 例如在日欄位上設定"15W",表示離每月15號最近的那個工作日觸發。如果15號正好是週六,則找最近的週五(14號)觸發, 如果15號是周未,則找最近的下週一(16號)觸發.如果15號正好在工作日(週一至週五),則就在該天觸發。如果指定格式為 "1W",它則表示每月1號往後最近的工作日觸發。如果1號正是週六,則將在3號下週一觸發。(注,"W"前只能設定具體的數字,不允許區間"-").

'L'和 'W'可以一組合使用。如果在日欄位上設定"LW",則表示在本月的最後一個工作日觸發

# :序號(表示每月的第幾周星期幾),例如在周欄位上設定"6#3"表示在每月的第三個周星期六.注意如果指定"6#5",正好第五週沒有星期六,則不會觸發該配置(用在母親節和父親節再合適不過了)

周欄位的設定,若使用英文字母是不區分大小寫的 MON 與mon相同.

常用示例:

格式: [秒] [分] [小時] [日] [月] [周] [年]

0 0 12 * * ?           每天12點觸發 
0 15 10 ? * *          每天10點15分觸發 
0 15 10 * * ?          每天10點15分觸發  
0 15 10 * * ? *        每天10點15分觸發  
0 15 10 * * ? 2005     2005年每天10點15分觸發 
0 * 14 * * ?           每天下午的 2點到2點59分每分觸發 
0 0/5 14 * * ?         每天下午的 2點到2點59分(整點開始,每隔5分觸發)  
0 0/5 14,18 * * ?        每天下午的 18點到18點59分(整點開始,每隔5分觸發)

0 0-5 14 * * ?            每天下午的 2點到2點05分每分觸發 
0 10,44 14 ? 3 WED        3月分每週三下午的 2點10分和2點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 2002-2005  從2002年到2005年每月最後一週的星期五的10點15分觸發

0 15 10 ? * 6#3           每月的第三週的星期五開始觸發 
0 0 12 1/5 * ?            每月的第一個中午開始每隔5天觸發一次 
0 11 11 11 11 ?           每年的11月11號 11點11分觸發(光棍節)