轉(zhuǎn)自：yonghu86

cnblogs.com/huyong/p/11091089.html

轉(zhuǎn)自：yonghu86

cnblogs.com/huyong/p/11091089.html

一、Quartz.NET介紹

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

Quartz.NET允許開發(fā)人員根據(jù)時間間隔（或天）來調(diào)度作業(yè)。它實現(xiàn)了作業(yè)和觸發(fā)器的多對多關(guān)系，還能把多個作業(yè)與不同的觸發(fā)器關(guān)聯(lián)。

整合了 Quartz.NET的應(yīng)用程序可以重用來自不同事件的作業(yè)，還可以為一個事件組合多個作業(yè)。

官網(wǎng)：http://www.quartz-scheduler.net/

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

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

Quartz.NET是一個強(qiáng)大、開源、輕量的作業(yè)調(diào)度框架，是 OpenSymphony 的 Quartz API 的.NET移植，用C#改寫，可用于winform和Web應(yīng)用中。

它靈活而不復(fù)雜,你能夠用它來為執(zhí)行一個作業(yè)而創(chuàng)建簡單的或復(fù)雜的作業(yè)調(diào)度。

Quartz.NET 3.0 已經(jīng)開始支持 .NET Core/.NET Standard 2.0。

展開全文

Job 為作業(yè)的接口，JobDetail 用來描述 Job 的實現(xiàn)類及其它相關(guān)的靜態(tài)信息；

Trigger 作為作業(yè)的定時管理工具，一個 Trigger 只能對應(yīng)一個作業(yè)實例，而一個作業(yè)實例可對應(yīng)多個 Trigger ；

Scheduler 做為定時任務(wù)容器，它包含了所有觸發(fā)器和作業(yè)，每個 Scheduler 都存有 JobDetail 和 Trigger的注冊，一個 Scheduler 中可以注冊多個 JobDetail 和多個 Trigger 。

二、依賴框架

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

2.1、使用Nuget添加使用

2.1.0、創(chuàng)建一個項目

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

要使用Quartz.NET我們需要安裝Quartz.NET包，最簡單的方式就是從Quartz.NET管網(wǎng)下載dll文件引用即可。本文我們使用Nuget進(jìn)行dll文件的引用與管理。

要使用Nuget必須確保已經(jīng)安裝過，最簡單的方式是通過VS“工具”菜單查看是否有程序包管理控制臺，如果有說明已經(jīng)安裝過，如下圖所示。

如果沒有找到那我們就要進(jìn)行安裝。

2.1.2、安裝Nuget

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

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

2.1.3、使用nuget安裝Quartz.NET

點(diǎn)擊“工具”-"NuGet包管理器"-“程序包管理器控制臺”

輸入安裝包的命令：

Install-PackageQuartz

安裝結(jié)果如下：

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

三、Quartz.NET應(yīng)用

假定要實現(xiàn)每隔5秒鐘向控制臺記錄當(dāng)前時間。

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

3.1、定義要執(zhí)行的任務(wù)

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

usingSystem;

usingSystem.Threading.Tasks;

namespaceQuartzTest

{

usingQuartz;

publicclassTimeJob: IJob

{

///summary

///作業(yè)調(diào)度定時執(zhí)行的方法

////summary

///param name="context"/param

///returns/returns

publicasyncTask Execute(IJobExecutionContext context)

{

awaitConsole.Out.WriteLineAsync("Hello QuartzNet..."+ DateTime.Now + Environment.NewLine);

}

}

}

3.2、創(chuàng)建一個調(diào)度器

調(diào)度器負(fù)責(zé)管理與控制任務(wù)的執(zhí)行，在Main方法中添加如下代碼：

//調(diào)度器

IScheduler scheduler;

//調(diào)度器工廠

ISchedulerFactory factory;

//創(chuàng)建一個調(diào)度器

factory = newStdSchedulerFactory;

scheduler = factory.GetScheduler;

scheduler.Start;

3.3、創(chuàng)建一個任務(wù)對象

這個任務(wù)對象就是我們將要執(zhí)行的工作，job1是名稱，group1是組名。

//2、創(chuàng)建一個任務(wù)

IJobDetail job = JobBuilder.Create.WithIdentity("job1", "group1").Build;

3.4、創(chuàng)建一個觸發(fā)器

觸發(fā)器定義了什么時間任務(wù)開始或每隔多久執(zhí)行一次。

//3、創(chuàng)建一個觸發(fā)器

//DateTimeOffset runTime = DateBuilder.EvenMinuteDate(DateTimeOffset.UtcNow);

ITrigger trigger = TriggerBuilder.Create

.WithIdentity("trigger1", "group1")

.WithCronSchedule("0/5 * * * * ?") //5秒執(zhí)行一次

.Build;

3.5、將任務(wù)與觸發(fā)器添加到調(diào)度器中并執(zhí)行

//4、將任務(wù)與觸發(fā)器添加到調(diào)度器中

scheduler.ScheduleJob(job, trigger);

//5、開始執(zhí)行

scheduler.Start;

3.6、運(yùn)行結(jié)果

3.7 Main方法完整代碼

usingQuartz;

usingQuartz.Impl;

usingSystem;

namespaceQuartzTest

{

classProgram

{

staticvoidMain(string[] args)

{

//1、調(diào)度器

ISchedulerFactory sf = newStdSchedulerFactory;

IScheduler sched = sf.GetScheduler;

//2、創(chuàng)建一個任務(wù)

IJobDetail job = JobBuilder.CreateTimeJob

.WithIdentity("job1", "group1")

.Build;

//3、創(chuàng)建一個觸發(fā)器

//DateTimeOffset runTime = DateBuilder.EvenMinuteDate(DateTimeOffset.UtcNow);

ITrigger trigger = TriggerBuilder.Create

.WithIdentity("trigger1", "group1")

.WithCronSchedule("0/5 * * * * ?") //5秒執(zhí)行一次

.Build;

sched.ScheduleJob(job, trigger);

//啟動任務(wù)

sched.Start;

}

}

}

四、Quartz的cron表達(dá)式

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

1、Seconds Minutes Hours DayofMonth Month DayofWeek Year

2、Seconds Minutes Hours DayofMonth Month DayofWeek

結(jié)構(gòu)

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

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

Cron各字段的含義

通配符說明

星號(*)：可用在所有字段中，表示對應(yīng)時間域的每一個時刻，例如， 在分鐘字段時，表示“每分鐘”；

問號(?)：該字符只在日期和星期字段中使用，它通常指定為“無意義的值”，相當(dāng)于點(diǎn)位符；

減號(-)：表達(dá)一個范圍，如在小時字段中使用“10-12”，則表示從10到12點(diǎn)，即10,11,12；

逗號(,)：表達(dá)一個列表值，如在星期字段中使用“MON,WED,FRI”，則表示星期一，星期三和星期五；

斜杠(/)：x/y表達(dá)一個等步長序列，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出現(xiàn)在星期字段里，而且在前面有一個數(shù)值X，則表示“這個月的最后X天”，例如，6L表示該月的最后星期五；

W：該字符只能出現(xiàn)在日期字段里，是對前導(dǎo)日期的修飾，表示離該日期最近的工作日。例如15W表示離該月15號最近的工作日，如果該月15號是星期六，則匹配14號星期五；如果15日是星期日，則匹配16號星期一；如果15號是星期二，那結(jié)果就是15號星期二。但必須注意關(guān)聯(lián)的匹配日期不能夠跨月，如你指定1W，如果1號是星期六，結(jié)果匹配的是3號星期一，而非上個月最后的那天。W字符串只能指定單一日期，而不能指定日期范圍；

LW組合：在日期字段可以組合使用LW，它的意思是當(dāng)月的最后一個工作日；

井號(#)：該字符只能在星期字段中使用，表示當(dāng)月某個工作日。如6#3表示當(dāng)月的第三個星期五(6表示星期五，#3表示當(dāng)前的第三個)，而4#5表示當(dāng)月的第五個星期三，假設(shè)當(dāng)月沒有第五個星期三，忽略不觸發(fā)；

C：該字符只在日期和星期字段中使用，代表“Calendar”的意思。它的意思是計劃所關(guān)聯(lián)的日期，如果日期沒有被關(guān)聯(lián)，則相當(dāng)于日歷中所有日期。例如5C在日期字段中就相當(dāng)于日歷5日以后的第一天。1C在星期字段中相當(dāng)于星期日后的第一天。

Cron表達(dá)式對特殊字符的大小寫不敏感，對代表星期的縮寫英文大小寫也不敏感。

一些例子：

表示式 說明

0 0 12 * * ? 每天12點(diǎn)運(yùn)行

0 15 10 ? * * 每天10:15運(yùn)行

0 15 10 * * ? 每天10:15運(yùn)行

0 15 10 * * ? * 每天10:15運(yùn)行

0 15 10 * * ? 2008 在2008年的每天10：15運(yùn)行

0 * 14 * * ? 每天14點(diǎn)到15點(diǎn)之間每分鐘運(yùn)行一次，開始于14:00，結(jié)束于14:59。

0 0/5 14 * * ? 每天14點(diǎn)到15點(diǎn)每5分鐘運(yùn)行一次，開始于14:00，結(jié)束于14:55。

0 0/5 14,18 * * ? 每天14點(diǎn)到15點(diǎn)每5分鐘運(yùn)行一次，此外每天18點(diǎn)到19點(diǎn)每5鐘也運(yùn)行一次。

0 0-5 14 * * ? 每天14:00點(diǎn)到14:05，每分鐘運(yùn)行一次。

0 10,44 14 ? 3 WED 3月每周三的14:10分到14:44，每分鐘運(yùn)行一次。

0 15 10 ? * MON-FRI 每周一，二，三，四，五的10:15分運(yùn)行。

0 15 10 15 * ? 每月15日10:15分運(yùn)行。

0 15 10 L * ? 每月最后一天10:15分運(yùn)行。

0 15 10 ? * 6L 每月最后一個星期五10:15分運(yùn)行。

0 15 10 ? * 6L 2007-2009 在2007,2008,2009年每個月的最后一個星期五的10:15分運(yùn)行。

0 15 10 ? * 6#3 每月第三個星期五的10:15分運(yùn)行。

注意：

有些子表達(dá)式能包含一些范圍或列表

例如：子表達(dá)式（天（星期））可以為 “MON-FRI”，“MON，WED，F(xiàn)RI”，“MON-WED,SAT”

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

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

“/”字符用來指定數(shù)值的增量

例如：在子表達(dá)式（分鐘）里的“0/15”表示從第0分鐘開始，每15分鐘

在子表達(dá)式（分鐘）里的“3/20”表示從第3分鐘開始，每20分鐘（它和“3，23，43”）的含義一樣

“？”字符僅被用于天（月）和天（星期）兩個子表達(dá)式，表示不指定值

當(dāng)2個子表達(dá)式其中之一被指定了值以后，為了避免沖突，需要將另一個子表達(dá)式的值設(shè)為“？”

“L” 字符僅被用于天（月）和天（星期）兩個子表達(dá)式

它是單詞“l(fā)ast”的縮寫

但是它在兩個子表達(dá)式里的含義是不同的。

在天（月）子表達(dá)式中，“L”表示一個月的最后一天

在天（星期）自表達(dá)式中，“L”表示一個星期的最后一天，也就是SAT

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

例如：“6L”表示這個月的倒數(shù)第６天，“FRIL”表示這個月的最一個星期五

注意：在使用“L”參數(shù)時，不要指定列表或范圍，因為這會導(dǎo)致問題

表達(dá)式生成器

有很多的cron表達(dá)式在線生成器，這里給大家推薦幾款

http://www.pdtools.net/tools/becron.jsp

http://cron.qqe2.com/

版權(quán)聲明：本文來源于網(wǎng)友收集或網(wǎng)友供稿，僅供學(xué)習(xí)交流之用，如果有侵權(quán)，請轉(zhuǎn)告小編或者留言，本公眾號立即刪除。

支持小薇

關(guān)注公眾號↑↑↑：DotNet開發(fā)跳槽?

點(diǎn)分享

點(diǎn)收藏

點(diǎn)點(diǎn)贊

點(diǎn)在看