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 CodeOK,上面的就是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分觸發(光棍節)