C#基于Quartz.NET实现任务调度并部署Windows服务

一、Quartz.NET介绍

Quartz.NET是一个强大、开源、轻量的作业调度框架，是 OpenSymphony 的 Quartz API 的.NET移植，用C#改写，可用于winform和asp.net mvc、.Net Core应用中。它灵活而不复杂。你能够用它来为执行一个作业而创建简单的或复杂的作业调度。它有很多特征，如：数据库支持，集群，插件，支持cron-like表达式等等。

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

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

二、Quartz.NET用途

 一，可以定时发邮件通知。 

二 ， 电商网站的定时打折活动。（比如规定11月11日 淘宝购买女朋友打八折）

三， 定时对数据更新 或者添加。

四，自己朋友生日。 可以定时发生日祝福。 等等 （我也不一一举例了） 

三、Quartz.NET安装

我使用的VS版本是2017的  选择工具  - NuGet包管理 - 管理解决方案的NuGet包   输入 Quartz.NET 安装

还可以通过NuGet控制台 通过安装命令  

Install-Package Quartz

四、Quartz.NET实现思路

一：继承并实现IJob接口，在Execute 方法中写你要定时执行的事情（切记 ）

二：使用Quartz创建任务调度核心代码步骤

　　1、配置Quartz，创建工厂，开启调度。

　　2、创建工作任务

　　3、创建触发器

　　4、将任务加入到任务池

三：添加任务，使用Topshelf部署Windows服务，定时执行

五、代码步骤讲解

一：继承并实现IJob接口，在Execute 方法中写你要做的事情（切记 ）

　　　

using Quartz.Utility;
using System;
using System.IO;
using System.Threading.Tasks;

namespace Quartz.JobWork
{
    public class MyJob : IJob
    {
        public Task Execute(IJobExecutionContext context)
        {
            Task task = null;
            try
            {
                string fileName = "printlog.txt";
                StreamWriter writer = new StreamWriter(fileName, true);
                task = writer.WriteLineAsync(string.Format("{0},测试", DateTime.Now.ToLongTimeString()));
                writer.Close();
                writer.Dispose();
            }
            catch (Exception ex)
            {
                LogHelper.WriteLog(ex.Message.ToString(), ex);
            }
            return task;
        }
    }
}

 

二：使用Quartz创建任务调度核心代码步骤

注：这里提供一个QuartzHelper帮助类，直接把以下代码copy过去即可用，只需要重写Execute方法即可。Quartz3.0及以上的版本是采用的异步，3.0以下的版本没有采用异步，使用方法是一样的

using Quartz.Impl;
using System;
using System.Collections.Generic;
using System.Collections.Specialized;
using System.Linq;
using System.Text;
using System.Threading;
using System.Threading.Tasks;

namespace Quartz.Utility
{
    public class QuartzHelper
    {
        static readonly IScheduler _scheduler;
        static QuartzHelper()
        {
            //创建一个工厂
            var schedulerFactory = new StdSchedulerFactory();
            //启动
            _scheduler = schedulerFactory.GetScheduler().Result;
            //1、开启调度
            _scheduler.Start();
        }
        /// <summary>
        /// 时间间隔执行任务
        /// </summary>
        /// <typeparam name="T">任务类，必须实现IJob接口</typeparam>
        /// <param name="seconds">时间间隔(单位：秒)</param>
        public static async Task<bool> ExecuteInterval<T>(int seconds) where T : IJob
        {
            //2、创建工作任务
            IJobDetail job = JobBuilder.Create<T>().Build();
            // 3、创建触发器
            ITrigger trigger = TriggerBuilder.Create()
           .StartNow()
           .WithSimpleSchedule(
                x =>x.WithIntervalInSeconds(seconds)
                //x.WithIntervalInMinutes(1)
                .RepeatForever())
           .Build();
            //4、将任务加入到任务池
            await _scheduler.ScheduleJob(job, trigger);
            return true;
        }

        /// <summary>
        /// 指定时间执行任务
        /// </summary>
        /// <typeparam name="T">任务类，必须实现IJob接口</typeparam>
        /// <param name="cronExpression">cron表达式，即指定时间点的表达式</param>
        public static async Task<bool> ExecuteByCron<T>(string cronExpression) where T : IJob
        {
            //2、创建工作任务
            IJobDetail job = JobBuilder.Create<T>().Build();
            //3、创建触发器
            ICronTrigger trigger = (ICronTrigger)TriggerBuilder.Create()
            .StartNow()
            .WithCronSchedule(cronExpression)
            .Build();
            //4、将任务加入到任务池
            await _scheduler.ScheduleJob(job, trigger);
            return true;
        }
    }
}

 

 三：添加任务，Topshelf部署Windows服务，定时执行

　　　　

namespace Quartz
{
    public class Program
    {
        static void Main(string[] args)
        {
            string cronExpression = "0 0 8,23 * * ? ";  //=>这是指每天的9点和16点执行任务
            cronExpression = "30 0/1 * * * ?";
            //QuartzHelper.ExecuteByCron<MyJob>(cronExpression).Wait();　　//=>这是调用Cron计划方法
            QuartzHelper.ExecuteInterval<MyJob>(180).Wait();
            /*
             简单说一下Cron表达式吧，

            由7段构成：秒 分 时 日 月 星期 年（可选）
 
            "-" ：表示范围  MON-WED表示星期一到星期三
            "," ：表示列举 MON,WEB表示星期一和星期三
            "*" ：表是“每”，每月，每天，每周，每年等
            "/" :表示增量：0/15（处于分钟段里面） 每15分钟，在0分以后开始，3/20 每20分钟，从3分钟以后开始
            "?" :只能出现在日，星期段里面，表示不指定具体的值
            "L" :只能出现在日，星期段里面，是Last的缩写，一个月的最后一天，一个星期的最后一天（星期六）
            "W" :表示工作日，距离给定值最近的工作日
            "#" :表示一个月的第几个星期几，例如："6#3"表示每个月的第三个星期五（1=SUN...6=FRI,7=SAT）
 
            如果Minutes的数值是 '0/15' ，表示从0开始每15分钟执行
 
            如果Minutes的数值是 '3/20' ，表示从3开始每20分钟执行，也就是‘3/23/43’
            */
            HostFactory.Run(x =>
            {
                x.UseLog4Net();
                x.Service<TownCrier>(s =>
                {
                    s.ConstructUsing(name => new TownCrier());
                    s.WhenStarted(tc => tc.Start());
                    s.WhenStopped(tc => tc.Stop());
                });
                x.RunAsLocalSystem();
                x.SetDescription("QuartzJob任务定时发送");
                x.SetDisplayName("QuartzJob");
                x.SetServiceName("QuartzJob");

                x.EnablePauseAndContinue();
            });
        }
    }
}

　　TownCrier服务实现类

public class TownCrier
    {
        readonly Timer _timer;
        public TownCrier()
        {
            _timer = new Timer(1000) { AutoReset = true };
            _timer.Elapsed += (sender, eventArgs) => Console.WriteLine("---------------------DateTime： {0} ------------------- ", DateTime.Now);
        }
        public void Start() { _timer.Start(); }
        public void Stop() { _timer.Stop(); }
    }