什么是定時任務？

最近恰巧有類似的需求, 需要做一個應用程序服務, 每天定時給服務器上傳采集的數據。

在沒有任務框架的使用前提下, 如果我們想要實現類似的需求,可以自己寫一個計時器, 然后24小時運行,達到指定的時間就運行。但是這樣不僅擴展性差, 而且不易于維護。

在定時任務這塊, 也有非常的多的框架支持,開箱即用, 那么下面將主要介紹一下Quartz.NET框架

Github

Quartz.NET介紹

Quartz.NET是一個Github開源項目，用于創建一個免費商業用途的作業調度框架。

注:支持 .NET Core/.NET Standard 2.0 和 .NET 框架 4.6.1 及更晚版本。

Quartz.NET入門

在我們使用定時任務框架的之前, 首先我們需要確定的是, 它大概具備哪些內容。

• 靈活的指定某項任務
• 靈活的啟動時間配置
• 傳遞參數并且監聽

了解了這些基礎概念之后, 我們便開始學習如何在Quartz.NET當中使用這些功能。

1.創建一個任務

任務是一個抽象的概念, 實際來說它應該指的是某種任務, 例如: 想要每3秒輸入一個字符串, 那么我們就可以這樣做。

• 下面演示創建了一個類, 它繼承于IJob接口, 實現了Execute方法, 任務就是輸出一個字符串。

    public class TestJob : IJob
    {
        public async Task Execute(IJobExecutionContext context)
        {
            await Console.Out.WriteLineAsync($"{DateTime.Now}:Hello!");
        }
    }

• 創建任務

            //創建一個工作
            IJobDetail job = JobBuilder.Create<TestJob>()
             .WithIdentity("TestJob", "Test")
            .Build();

2.配置任務的參數

為任務配置一個觸發條件及相關的參數。當該配置的參數一旦達到了條件, 上面的任務將被觸發。

            //創建一個觸發條件
            ITrigger trigger = TriggerBuilder.Create()
               .WithIdentity("TestJobTrigger", "Test")
               .WithSimpleSchedule(x =>
               {
                   x.WithIntervalInSeconds(3).RepeatForever();
               })
               .Build();

3.啟動任務

創建一個任務調度器, 將任務和配置參數添加到調度器當中。

            StdSchedulerFactory factory = new StdSchedulerFactory();
            //創建任務調度器
            IScheduler scheduler = await factory.GetScheduler();
            //啟動任務調度器
            scheduler.Start();  

            //將創建的任務和觸發器條件添加到創建的任務調度器當中
            scheduler.ScheduleJob(job, trigger);

4.實際效果

在上面的代碼中,我們創建了一個任務輸出一段字符串, 然后為該任務創建了一個配置, 每3秒執行一次, 那么實際效果會每間隔3秒輸出:

更多配置

• 特定時間觸發,重復觸發,單次觸發, 觸發次數,開始時間, 結束時間。 這些在框架當中都有該功能

• 觸發器表達式 ,例如: 每周一上午, 或每周一、周三、周五等等

  下面是一些表達式及其含義的示例示例 1 - 創建每 5 分鐘觸發一次的觸發器的表達式

"0 0/5 * * * ?"

示例 2 - 創建每 5 分鐘觸發一次的觸發器的表達式，在分鐘后 10 秒（即上午 10：00：10、上午 10：05：10 等）。

"10 0/5 * * * ?"

示例 3 - 用于創建觸發器的表達式，該觸發器在每個星期三和周五的 10：30、11：30、12：30 和 13：30 觸發。

"0 30 10-13 ? * WED,FRI"

示例 4 - 創建觸發器的表達式，在每月 5 日到 20 日上午 8 點到上午 10 點之間每半小時觸發一次。請注意，觸發器不會于上午 10：00 觸發，只是在 8：00、8：30、9：00 和 9：30

"0 0/30 8-9 5,20 * ?"

點擊查看更多觸發器表達式

• 監聽器: 可以檢測你的任務執行狀態: 是否工作, 是否錯誤,是否已完成等

關于具體的使用方法, 在文檔中有詳細的介紹:

查看Quartz.NET文檔