使用Topshelf+Quartz开发Windows定时任务

使用Topshelf开发Windows服务，比起直接写Windows服务的优势在于，可以直接运行调试。开发完成后，直接使用install命令注册为服务即可，简单高效。

一、准备工作

1. 创建一个控制台应用

   
   
   image.png

2. 在Nuget包管理器中搜索并安装Topshelf、Quartz、log4net这几个库

   
   
   image.png

使用Topshelf框架

1. 在程序入口类Program.cs中修改Main方法

using Topshelf;

namespace DemoService
{
    class Program
    {
        static void Main(string[] args)
        {
            string serviceName = "DemoService";
            HostFactory.Run(config =>
            {
                config.Service(s =>
                {
                    s.ConstructUsing(name => new StartService());
                    s.WhenStarted(service => service.Start());
                    s.WhenStopped(service => service.Stop());
                });

                config.RunAsLocalSystem();
                config.SetDescription(serviceName);
                config.SetServiceName(serviceName);
                config.SetDisplayName(serviceName);
            });
        }
    }
}

2. 新增类文件：StartService.cs，并编写Start()、Stop()方法，这两个方法在Main方法中被注册为服务的启动和停止方法。

namespace DemoService
{
    public class StartService
    {
        public void Start()
        {
        }
        public void Stop()
        {
        }
    }
}

二、配置日志工具log4net

1. 创建一个应用程序配置文件，改名为log4net.config
   

   image.png

2. 在log4net.config的项中写入如下配置项

3. 以上配置将会将Info日志保存至项目文件夹下的Log\\LogInfo\\，将错误日志保存至Log\\LogError\\，日志文件保存为.htm格式。
   

   转义字符对照表
   
   
   日志效果图

4. 在Properties下的AssemblyInfo.cs中注册一下log4net.config配置文件

[assembly: log4net.Config.XmlConfigurator(ConfigFile = "log4net.config", ConfigFileExtension = "config", Watch = true)]

5. 编写LogHelper.cs类

    public class LogHelper
    {
        //这里的 loginfo 和 log4net.config 里的名字要一样
        private static readonly log4net.ILog loginfo = log4net.LogManager.GetLogger("loginfo");
        //这里的 logerror 和 log4net.config 里的名字要一样
        private static readonly log4net.ILog logerror = log4net.LogManager.GetLogger("logerror");
        public static void Info(string message)
        {
            if (loginfo.IsInfoEnabled)
            {
                loginfo.Info(message);
            }
        }

        public static void Error(string message, Exception ex)
        {
            if (logerror.IsErrorEnabled)
            {
                logerror.Error(message, ex);
            }
        }
    }

三、使用Quartz编写定时任务

1. 创建一个DemoJob.cs类

using Quartz;
using System;

namespace DemoService.Jobs
{
    public class DemoJob : IJob
    {
        public void Execute(IJobExecutionContext context)
        {
            Console.WriteLine("Hello");
            LogHelper.Info("Hello");
        }
    }
}

2. 使用Quartz框架，打开StartService.cs文件，在Start()方法中添加如下内容

    public class StartService
    {
        public void Start()
        {
            // 开启调度
            ISchedulerFactory sf = new StdSchedulerFactory();
            IScheduler scheduler = sf.GetScheduler();
            IJobDetail job = JobBuilder.Create().Build();
            // 服务启动时执行一次
            // ITrigger triggerNow = TriggerBuilder.Create().StartNow().Build();

            // 每日22点执行一次
            ITrigger trigger = TriggerBuilder.Create()
                .StartNow()
                .WithCronSchedule("0 0 22 1/1 * ? ")
                .Build();
            
            scheduler.ScheduleJob(job, trigger);
            scheduler.Start();
            LogHelper.Info("服务开始执行。");
        }

       public void Stop()
        {

        }
    }

3. Cron表达式很强大，但刚上手需要一定的学习成本，此处附上一个生成表达式的工具：
   在线Cron表达式生成器传送门

4. 想了解Cron 表达式，可参考该篇博文：https://www.cnblogs.com/yanghj010/p/10875151.html

四、服务注册、卸载

编写如下两个批处理文件，放在生成的目录下，需要注册、卸载时，直接执行即可。

1. install.bat

cd /d "%~dp0"
生成的可执行文件名.exe install
net start DemoService
cmd

2. uninstall.bat

cd /d "%~dp0"
生成的可执行文件名.exe uninstall
cmd