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 properties = new NameValueCollection();
             // 设置线程池
             properties["quartz.threadPool.type"] = "Quartz.Simpl.SimpleThreadPool, Quartz";
             //设置线程池的最大线程数量
             properties["quartz.threadPool.threadCount"] = "";
             //设置作业中每个线程的优先级
             properties["quartz.threadPool.threadPriority"] = ThreadPriority.Normal.ToString();

             // 远程输出配置
             properties["quartz.scheduler.exporter.type"] = "Quartz.Simpl.RemotingSchedulerExporter, Quartz";
             properties["quartz.scheduler.exporter.port"] = "";  //配置端口号
             properties["quartz.scheduler.exporter.bindName"] = "QuartzScheduler";
             properties["quartz.scheduler.exporter.channelType"] = "tcp"; //协议类型

             //创建一个工厂
             var schedulerFactory = new StdSchedulerFactory(properties);
             //启动
             _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>().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() { AutoReset = true };
             _timer.Elapsed += (sender, eventArgs) => Console.WriteLine("---------------------DateTime： {0} ------------------- ", DateTime.Now);
         }
         public void Start() { _timer.Start(); }
         public void Stop() { _timer.Stop(); }
     }

　　最后就可以做自己想要做的事情了！

　　 下期讲解使用Topshelf部署Windows服务!