Topshelf一个用于使用.NET构建Windows服务框架

时间 2021-04-03

标签 windows 框架测试命令行调试日志 code orm 生命周期事件栏目 Windows 繁體版

原文原文链接

1 Topshelf是什么？

Topshelf是用于托管使用.NET框架编写的Windows服务的框架。服务的建立获得简化，从而使开发人员能够建立一个简单的控制台应用程序，能够使用Topshelf将其做为服务安装。缘由很简单：调试控制台应用程序比服务容易得多。一旦对应用程序进行了测试并准备投入生产，Topshelf即可以轻松地将应用程序即服务安装。windows

2 使用

2.1 建立应用程序

首先，建立一个新的控制台应用程序并从nuget获取Topshelf软件包框架

Topshelf

当您使用Topshelf时，我还建议装一下日志库，咱们能够选择日志框架Serilog。测试

Topshelf.Serilog
Serilog.Sinks.Console

2.2 建立服务类

而后，建立服务类。我将其命名为MyService。在这里放置将在Windows服务的特定生命周期事件中调用的方法。至少，添加一些用于启动和中止服务的方法。命令行

public class MyService
{
    readonly ILogger log = Log.ForContext(MethodBase.GetCurrentMethod().DeclaringType);
    public void Start()
    {
        log.Information("Starting MyService...");
    }

    public void Stop()
    {
        log.Information("Stopping MyService...");
    }
}

2.3 在Topshelf中注册服务

接着，在Topshelf中注册咱们的服务类。跳转到Program.cs并添加：调试

class Program
{
    static void Main(string[] args)
    {
        Log.Logger = new LoggerConfiguration()
            .WriteTo.Console()
            .MinimumLevel.Debug()
            .CreateLogger();

        var rc = HostFactory.Run(x =>
        {
            x.UseSerilog(); // HostLogger改成使用Serilog。
            x.SetDisplayName("个人服务");  // 咱们设置要在Windows服务监视器中使用的winservice的显示名称。
            x.SetDescription("个人服务详细描述"); // 咱们设置了在Windows服务监视器中使用的winservice的描述。
            x.SetServiceName("MyService"); // 咱们设置要在Windows服务监视器中使用的winservice的服务名称。
            x.Service<MyService>(s =>
            {
                s.ConstructUsing(name => new MyService()); // 构建服务实例。
                s.WhenStarted(tc => tc.Start()); // 启动服务
                s.WhenStopped(tc => tc.Stop()); // 中止服务
            });
            x.RunAsLocalSystem(); // 设置“登陆为”并选择了“本地系统”。
            x.StartAutomatically(); // 设置“启动类型”并选择了“自动”。
        });

        var exitCode = (int)Convert.ChangeType(rc, rc.GetTypeCode()); // 咱们转换并返回服务退出代码。
        Environment.ExitCode = exitCode;
    }
}

2.4 运行应用程序

接着，F5执行应用程序，若是一切顺利，你应该会看到相似如下内容的信息：
日志

2.5 安装Windows服务

最后，安装Windows服务，以管理员身份打开命令行，浏览到exe目录并使用install参数调用它：code

S045.Topshelf.ConsoleApp.exe install

如今，您能够在“服务”窗口中签出新注册的Windows服务。
orm