Quartz.Net實現作業定時調度詳解 原文:Quartz.Net實現作業定時調度詳解

1、Quartz.NET介紹

Quartz.NET是一個強大、開源、輕量的作業調度框架，你能夠用它來為執行一個作業而創建簡單的或復雜的作業調度。它有很多特征，如：數據庫支持，集群，插件，支持cron-like表達式等等。非常適合在平時的工作中，定時輪詢數據庫同步，定時郵件通知，定時處理數據等。

Quartz.NET允許開發人員根據時間間隔（或天）來調度作業。它實現了作業和觸發器的多對多關系，還能把多個作業與不同的觸發器關聯。整合了 Quartz.NET的應用程序可以重用來自不同事件的作業，還可以為一個事件組合多個作業。

官網：http://www.quartz-scheduler.net/

源碼：https://github.com/quartznet/quartznet

示例：https://www.quartz-scheduler.net/documentation/quartz-3.x/quick-start.html

Quartz.NET是一個強大、開源、輕量的作業調度框架，是 OpenSymphony 的 Quartz API 的.NET移植，用C#改寫，可用于winform和Web應用中。它靈活而不復雜,你能夠用它來為執行一個作業而創建簡單的或復雜的作業調度。Quartz.NET 3.0 已經開始支持 .NET Core/.NET Standard 2.0。

Job 為作業的接口，JobDetail 用來描述 Job 的實現類及其它相關的靜態信息；Trigger 作為作業的定時管理工具，一個 Trigger 只能對應一個作業實例，而一個作業實例可對應多個 Trigger ；Scheduler 做為定時任務容器，它包含了所有觸發器和作業，每個 Scheduler 都存有 JobDetail 和 Trigger
的注冊，一個 Scheduler 中可以注冊多個 JobDetail 和多個 Trigger 。

2、依賴框架

引入框架的方法非常簡單你可以直接用nuget管理包也可以在項目中添加引用。為了滿足不同客戶的需求，本文以最簡單的方式來講解在Visual Studio中如何正確使用Quartz.NET。

2.1、使用Nuget添加使用

2.1.0、創建一個項目

創建一個新項目，可以是ASP.NET MVC、WebForms、Winforms、.NET Core等多種.Net項目，這里使用的是VS2017，創建了一個控制臺應用項目。

要使用Quartz.NET我們需要安裝Quartz.NET包，最簡單的方式就是從Quartz.NET管網下載dll文件引用即可。本文我們使用Nuget進行dll文件的引用與管理。要使用Nuget必須確保已經安裝過，最簡單的方式是通過VS“工具”菜單查看是否有程序包管理控制臺，如果有說明已經安裝過，如下圖所示。

如果沒有找到那我們就要進行安裝。

2.1.2、安裝Nuget

新版本的Visual Studio默認情況是安裝了Nuget的，如Visual Studio 2015+，如果沒有安裝，打開VS菜單“工具”->"擴展與更新"。

在擴展與更新中搜索“nuget”，可以新安裝或卸載后升級。

2.1.3、使用nuget安裝Quartz.NET

點擊“工具”->"NuGet包管理器"->“程序包管理器控制臺”

輸入安裝包的命令：

Install-Package Quartz

安裝結果如下：

時包管理器中就下載了需要的程序集與相關文件，同時程序中也添加了引用。

3、Quartz.NET應用

假定要實現每隔5秒鐘向控制臺記錄當前時間。

因為這是一個控制臺應用，我想一啟動時就開始該項工作，這里我們需要將代碼寫在static void Main(string[] args)方法中。

3.1、定義要執行的任務

定義一個類，實現Quartz.IJob接口，實現方法Execute，TimeJob.cs文件的代碼如下：

using System; using System.Threading.Tasks;namespace QuartzTest {using Quartz;public class TimeJob : IJob{/// <summary>/// 作業調度定時執行的方法/// </summary>/// <param name="context"></param>/// <returns></returns>public async Task Execute(IJobExecutionContext context){await Console.Out.WriteLineAsync("Hello QuartzNet..." + DateTime.Now + Environment.NewLine); }} }

3.2、創建一個調度器

調度器負責管理與控制任務的執行，在Main方法中添加如下代碼：

//調度器 IScheduler scheduler; //調度器工廠 ISchedulerFactory factory;//創建一個調度器 factory = new StdSchedulerFactory(); scheduler = factory.GetScheduler(); scheduler.Start();

3.3、創建一個任務對象

這個任務對象就是我們將要執行的工作，job1是名稱，group1是組名。
//2、創建一個任務
IJobDetail job = JobBuilder.Create().WithIdentity("job1", "group1").Build();

3.4、創建一個觸發器

觸發器定義了什么時間任務開始或每隔多久執行一次。

//3、創建一個觸發器 //DateTimeOffset runTime = DateBuilder.EvenMinuteDate(DateTimeOffset.UtcNow); ITrigger trigger = TriggerBuilder.Create().WithIdentity("trigger1", "group1").WithCronSchedule("0/5 * * * * ?") //5秒執行一次.Build();

3.5、將任務與觸發器添加到調度器中并執行

//4、將任務與觸發器添加到調度器中 scheduler.ScheduleJob(job, trigger); //5、開始執行 scheduler.Start();

3.6、運行結果

3.7 Main方法完整代碼

using Quartz; using Quartz.Impl; using System;namespace QuartzTest {class Program{static void Main(string[] args){//1、調度器ISchedulerFactory sf = new StdSchedulerFactory();IScheduler sched = sf.GetScheduler();//2、創建一個任務IJobDetail job = JobBuilder.Create<TimeJob>().WithIdentity("job1", "group1").Build();//3、創建一個觸發器//DateTimeOffset runTime = DateBuilder.EvenMinuteDate(DateTimeOffset.UtcNow);ITrigger trigger = TriggerBuilder.Create().WithIdentity("trigger1", "group1").WithCronSchedule("0/5 * * * * ?") //5秒執行一次 .Build();sched.ScheduleJob(job, trigger);//啟動任務sched.Start();}} }

4、Quartz的cron表達式

　Cron表達式是一個字符串，字符串以5或6個空格隔開，分為6或7個域，每一個域代表一個含義，Cron有如下兩種語法格式：

　　（1）?Seconds Minutes Hours DayofMonth Month DayofWeek Year

　　（2）Seconds Minutes Hours DayofMonth Month DayofWeek

結構

　　corn從左到右（用空格隔開）：秒 分 小時 月份中的日期 月份 星期中的日期 年份（可為空）

　　例 ?"0 0 12 ? * WED" 在每星期三下午12:00 執行（年份通常 省略）

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表達式對特殊字符的大小寫不敏感，對代表星期的縮寫英文大小寫也不敏感。

一些例子：

表示式 說明

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）有些子表達式能包含一些范圍或列表

　　例如：子表達式（天（星期））可以為 “MON-FRI”，“MON，WED，FRI”，“MON-WED,SAT”

“*”字符代表所有可能的值

　　因此，“”在子表達式（月）里表示每個月的含義，“”在子表達式（天（星期））表示星期的每一天

　　“/”字符用來指定數值的增量?
　　例如：在子表達式（分鐘）里的“0/15”表示從第0分鐘開始，每15分鐘?
在子表達式（分鐘）里的“3/20”表示從第3分鐘開始，每20分鐘（它和“3，23，43”）的含義一樣

　　“？”字符僅被用于天（月）和天（星期）兩個子表達式，表示不指定值?
　　當2個子表達式其中之一被指定了值以后，為了避免沖突，需要將另一個子表達式的值設為“？”

　　“L” 字符僅被用于天（月）和天（星期）兩個子表達式，它是單詞“last”的縮寫?
　　但是它在兩個子表達式里的含義是不同的。?
　　在天（月）子表達式中，“L”表示一個月的最后一天?
　　在天（星期）自表達式中，“L”表示一個星期的最后一天，也就是SAT

　　如果在“L”前有具體的內容，它就具有其他的含義了

　　例如：“6L”表示這個月的倒數第６天，“FRIL”表示這個月的最一個星期五?
　　注意：在使用“L”參數時，不要指定列表或范圍，因為這會導致問題

表達式生成器
有很多的cron表達式在線生成器，這里給大家推薦幾款
http://www.pdtools.net/tools/becron.jsp

或者

http://cron.qqe2.com/

5、其他文章參考

• 微信公眾號開發系列-玩轉微信開發-目錄匯總

• RDIFramework.NET — 基于.NET的快速信息化系統開發框架 — 系列目錄

• RDIFramework.NET ━ .NET快速信息化系統開發框架 ━ 工作流程組件介紹

• RDIFramework.NET框架SOA解決方案（集Windows服務、WinForm形式與IIS形式發布）-分布式應用

• RDIFramework.NET代碼生成器全新V3.5版本發布-重大升級

---

一路走來數個年頭，感謝RDIFramework.NET框架的支持者與使用者，大家可以通過下面的地址了解詳情。

RDIFramework.NET官方網站：http://www.rdiframework.net/

RDIFramework.NET官方博客：http://blog.rdiframework.net/

同時需要說明的，以后的所有技術文章以官方網站為準，歡迎大家收藏！

RDIFramework.NET框架由專業團隊長期打造、一直在更新、一直在升級，請放心使用！

歡迎關注RDIFramework.net框架官方公眾微信（微信號：guosisoft），及時了解最新動態。

掃描二維碼立即關注

posted on 2019-06-29 09:35 NET未來之路 閱讀(...) 評論(...) 編輯 收藏

轉載于:https://www.cnblogs.com/lonelyxmas/p/11105748.html

總結

以上是生活随笔為你收集整理的Quartz.Net实现作业定时调度详解的全部內容，希望文章能夠幫你解決所遇到的問題。

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