Quartz.NET 使用入門整理二（搭建quartz.net專案）

Quartz.NET 使用入門整理二（搭建quartz.net專案）

1、新建一個空的控制檯程式

2、使用nuget或者包控制檯安裝

Install-Package Quartz

Install-Package Common.Logging.Log4Net1211

Install-Package log4net

Install-Package Topshelf 

Install-Package Topshelf.Log4Net

注意：如果你本機沒有安裝最新的.net framework 4.5.2，就不要使用nuget 安裝Topshelf 和Topshelf.Log4Net，因為最新的4.x版本都是基於.net framework 4.5.2，會報錯：

這個時候只需要指定安裝版本即可，topshelf 3.x的最後版本是3.3.1：

Install-Package Topshelf -Version 3.3.1

Install-Package Topshelf.Log4Net -Version 3.3.1

3、quartz.net基於topshelf作為服務job載體，如果沒有使用接觸過topshelf，可以先看看這幾篇文章：http://www.80iter.com/tag/Topshelf

4、新建測試job1和job2，用於測試job執行情況

5、使用topshelf進行job排程，這裡使用的是topshelf的custom service模式

public sealed class ServiceRunner : ServiceControl, ServiceSuspend
{
    private readonly IScheduler scheduler;
    public ServiceRunner()
    {
        scheduler = StdSchedulerFactory.GetDefaultScheduler();
    }
    public bool Start(HostControl hostControl)
    {
        scheduler.Start();
        return true;
    }
    public bool Stop(HostControl hostControl)
    {
        scheduler.Shutdown(false);
        return true;
    }
    public bool Continue(HostControl hostControl)
    {
        scheduler.ResumeAll();
        return true;
    }
    public bool Pause(HostControl hostControl)
    {
        scheduler.PauseAll();
        return true;
    }
}

6、配置quartz.config、quartz_jobs.xml、log4net.config

注意：由於需要部署，所以講上面三個檔案的屬性->複製到輸出目錄->選擇始終複製

lognet的配置跟以前使用一樣就ok，就是記錄服務執行的狀態日誌而已

7、編譯通過後啟動程式

8、基於7步的執行結果簡單說明下job的配置引數

simple 簡單任務的觸發器，可以排程用於重複執行的任務

name(必填) 觸發器名稱，同一個分組中的名稱必須不同
group(選填) 觸發器組
description(選填) 觸發器描述
job-name(必填) 要排程的任務名稱，該job-name必須和對應job節點中的name完全相同
job-group(選填) 排程任務(job)所屬分組，該值必須和job中的group完全相同
start-time(選填) 任務開始執行時間utc時間，北京時間需要+08:00，如：<start-time>2012-04-01T08:00:00+08:00</start-time>表示北京時間2012年4月1日上午8:00開始執行，注意服務啟動或重啟時都會檢測此屬性，若沒有設定此屬性或者start-time設定的時間比當前時間較早，則服務啟動後會立即執行一次排程，若設定的時間比當前時間晚，服務會等到設定時間相同後才會第一次執行任務，一般若無特殊需要請不要設定此屬性
repeat-count(必填)  任務執行次數，如:<repeat-count>-1</repeat-count>表示無限次執行，<repeat-count>10</repeat-count>表示執行10次
repeat-interval(必填) 任務觸發間隔(毫秒)，如:<repeat-interval>10000</repeat-interval> 每10秒執行一次

cron複雜任務觸發器--使用cron表示式定製任務排程

name(必填) 觸發器名稱，同一個分組中的名稱必須不同
group(選填) 觸發器組d
escription(選填) 觸發器描述
job-name(必填) 要排程的任務名稱，該job-name必須和對應job節點中的name完全相同
job-group(選填) 排程任務(job)所屬分組，該值必須和job中的group完全相同
start-time(選填) 任務開始執行時間utc時間，北京時間需要+08:00，如：<start-time>2012-04-01T08:00:00+08:00</start-time>表示北京時間2012年4月1日上午8:00開始執行，注意服務啟動或重啟時都會檢測此屬性，若沒有設定此屬性，服務會根據cron-expression的設定執行任務排程；若start-time設定的時間比當前時間較早，則服務啟動後會忽略掉cron-expression設定，立即執行一次排程，之後再根據cron-expression執行任務排程；若設定的時間比當前時間晚，則服務會在到達設定時間相同後才會應用cron-expression，根據規則執行任務排程，一般若無特殊需要請不要設定此屬性
cron-expression(必填) cron表示式，如:<cron-expression>0/10 * * * * ?</cron-expression>每10秒執行一次

所以7步中的job1和job2都在服務啟動的時候立刻執行了一次job，不同在於job1的間隔基於第一次執行時間，job2的間隔基於整點配置時間

job2中的配置使用的是quartz的cron表示式，可以參照官網進行配置

cron expressions 整體上還是非常容易理解的，只有一點需要注意："?"號的用法，看下文可以知道“？”可以用在 day of month 和 day of week中，他主要是為了解決如下場景，如：每月的1號的每小時的31分鐘，正確的表示式是：* 31 * 1 * ？，而不能是：* 31 * 1 * *，因為這樣代表每週的任意一天。

由7段構成：秒 分 時 日 月 星期 年（可選）
"-" ：表示範圍  MON-WED表示星期一到星期三
"," ：表示列舉 MON,WEB表示星期一和星期三
"*" ：表是“每”，每月，每天，每週，每年等
"/" :表示增量：0/15（處於分鐘段裡面） 每15分鐘，在0分以後開始，3/20 每20分鐘，從3分鐘以後開始
"?" :只能出現在日，星期段裡面，表示不指定具體的值
"L" :只能出現在日，星期段裡面，是Last的縮寫，一個月的最後一天，一個星期的最後一天（星期六）
"W" :表示工作日，距離給定值最近的工作日
"#" :表示一個月的第幾個星期幾，例如："6#3"表示每個月的第三個星期五（1=SUN...6=FRI,7=SAT）

官方例項：

Expression Meaning
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期間的每1分鐘觸發
0 0/5 14 * * ? 在每天下午2點到下午2:55期間的每5分鐘觸發
0 0/5 14,18 * * ? 在每天下午2點到2:55期間和下午6點到6:55期間的每5分鐘觸發
0 0-5 14 * * ? 在每天下午2點到下午2:05期間的每1分鐘觸發
0 10,44 14 ? 3 WED 每年三月的星期三的下午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 L-2 * ? Fire at 10:15am on the 2nd-to-last last day of every month
0 15 10 ? * 6L 每月的最後一個星期五上午10:15觸發
0 15 10 ? * 6L Fire at 10:15am on the last Friday of every month
0 15 10 ? * 6L 2002-2005 2002年至2005年的每月的最後一個星期五上午10:15觸發
0 15 10 ? * 6#3 每月的第三個星期五上午10:15觸發
0 0 12 1/5 * ? Fire at 12pm (noon) every 5 days every month, starting on the first day of the month.
0 11 11 11 11 ? Fire every November 11th at 11:11am.
 

9、本地除錯成功後，就需要釋出，然後進行部署，topshelf程式部署請參照：http://www.80iter.com/blog/1451523192435464

10、demo下載參照附件

由龐順龍最後編輯於：3年前

內容均為作者獨立觀點，不代表八零IT人立場，如涉及侵權，請及時告知。