.net 中worker service的使用入门

译者注：
请先完成以下准备工作，以便于您理解本文。
1、下载并安装最新的 .net sdk：https://dotnet.microsoft.com/download
2、命令行运行dotnet new worker -n "myservice"命令，创建一个 worker service 项目。

什么是 .net core worker service？

worker service 是使用模板构建的 .net 项目，该模板提供了一些有用的功能，可以将常规控制台应用程序变得更加强大。worker service 运行于宿主(host)的概念之上，宿主维护应用程序的生命周期。宿主还提供了一些常见的特性，如依赖注入、日志记录和配置。

worker service 通常是长时间运行的服务，执行一些规律发生的工作负载。

§worker service 的一些例子

处理来自队列、服务总线或事件流的消息、事件
响应对象、文件存储中的文件更改
聚合数据存储中的数据
丰富数据提取管道中的数据
ai/ml 数据集的格式化和清理

还可以开发一个这样的 worker service，该服务从头到尾执行一个过程，然后关闭。结合调度程序，便可以支持定期的批处理工作负载。例如，调度程序每隔一小时启动一次服务，完成一些汇总数据的计算，然后关闭。

worker service 没有用户界面，也不支持直接的用户交互，它们特别适用于设计微服务架构。在微服务体系结构中，职责通常被划分为不同的、可单独部署的、可伸缩的服务。随着微服务架构的成长和发展，拥有大量的 worker service 会变得越来越常见。

worker service 模板提供了什么？

完全可以在不使用 worker service 模板的情况下开发长时间运行的 worker service。在 .net core 的早期版本中我是这样做的，使用依赖注入容器手动建立宿主，然后启动我的处理工作负载。

在默认情况下，worker service 模板包含了有用的基础组件，比如依赖注入，这样我们就可以集中精力在其上构建业务逻辑。它包含了一个管理应用程序生命周期的宿主。

worker service 模板本身是相当基础的，它只包含了三个开箱即用的核心文件。

§1. program.cs

第一个是program类。该类包含 .net 控制台应用程序所必需的main方法入口点，.net 运行时期望在启动 .net 应用程序时在program类中查找此方法。

public class program
{
  public static void main(string[] args)
  {
      createhostbuilder(args).build().run();
  }

  public static ihostbuilder createhostbuilder(string[] args) =>
      host.createdefaultbuilder(args)
          .configureservices((hostcontext, services) =>
          {
              services.addhostedservice<worker>();
          });
}

在program类中，作为 worker service 模板一部分的是createhostbuilder方法，该方法创建一个ihostbuilder。ihostbuilder接口定义了一个类型，该类型使用生成器模式生成ihost的实例。此模板通过调用host类中的静态createdefaultbuilder方法来创建一个新的hostbuilder。

然后，它使用生成器来配置ihost，该ihost被用于运行 worker service 应用程序。宿主提供了依赖注入容器和日志记录等功能，就像我们可以在 asp.net core 应用程序中使用的那样。事实上，从 .net core 3.0 开始，asp.net core web 应用程序和 .net core worker service 都运行在同一ihost上的。

默认情况下，它包含了一个服务注册，稍后我会在本文中介绍，暂时不用担心。

从main方法中调用createdefaultbuilder方法，将构建并立即运行宿主。当 .net 运行时调用main方法时，应用程序启动，宿主将保持运行，监听标准的关闭信号（例如按下ctrl+c键）。

§2. appsettings.json

如果您以前使用过 asp.net core，将会非常熟悉appsettings.json文件，它是应用程序配置的常见来源之一。宿主被设计为，当启动应用程序时，使用任意已注册的配置提供程序从多个来源加载应用程序配置。其中一种提供程序是从appsettings.json加载配置，该文件内容由 json 组成，其结构包含表示应用程序配置的键和值。这些值可以随意地定义在对相关配置按逻辑分组成的片段（sections）内。

在 worker service 中，启动时会检查相同的配置源（包括此appsettings.json文件和环境变量），并从不同的源构建最终的配置。默认情况下会加载多种默认的提供程序，因此也会加载多种源。如果需要，您也可以自定义宿主用来加载配置数据的提供程序。

{
"logging": {
  "loglevel": {
    "default": "information",
    "microsoft": "warning",
    "microsoft.hosting.lifetime": "information"
  }
}
}

模板中的默认appsettings文件中包含日志记录库的配置设置项，默认对 worker service 可用。这里的配置是为某些日志记录上下文设置记录级别的。

§3. worker.cs

worker是一个您在默认的 asp.net core 项目模板中见不到的新类。它是托管服务与宿主相结合的魔力所在，提供了 worker service 的基础。

让我们来看一下它的代码：

public class worker : backgroundservice
{
  private readonly ilogger<worker> _logger;

  public worker(ilogger<worker> logger)
  {
      _logger = logger;
  }

  protected override async task executeasync(cancellationtoken stoppingtoken)
  {
      while (!stoppingtoken.iscancellationrequested)
      {
          _logger.loginformation("worker running at: {time}", datetimeoffset.now);
          await task.delay(1000, stoppingtoken);
      }
  }
}

此类从backgroundservice抽象基类派生。backgroundservice类实现了一个名为ihostedservice的接口。

backgroundservice包含一个名为executeasync的抽象方法，我们必须在子类中重写该方法，就像 worker service 模板中提供的worker类中所做的那样。executeasync方法返回一个task，在backgroundservice内部，期望此task是一些长时间运行的工作负载。该task会被启动并在后台运行。

在内部，宿主将启动ihostedservice的所有注册实现（包括从backgroundservice抽象类派生的类型）。请记住，backgroundservice为我们实现了ihostedservice。

§4. 如何注册托管服务(ihostedservice)？

下一个显而易见的问题是，如何注册ihostedservice？如果我们返回到program.cs的代码，我们将会找到答案：

public static ihostbuilder createhostbuilder(string[] args) =>
  host.createdefaultbuilder(args)
      .configureservices((hostcontext, services) =>
      {
          services.addhostedservice<worker>();
      });

在configureservices方法中，可以向依赖注入容器注册类型。addhostedservice是为iservicecollection定义的一个扩展方法，它允许我们注册一个实现了ihostedservice的类。

该模板中已将worker类注册为托管服务。

在启动时，宿主将找到已注册的ihostedservice的所有实例，并按顺序启动它们，此时，它们的长时间运行的工作负载会作为后台任务来运行。

为什么要构建 .net core worker service？

简单的答案是――何时以及是否需要它们！如果您需要开发一个微服务，它没有用户界面，并执行长时间运行的工作，那么 worker service 很可能是一个好的选择。

请记住，worker service 的底层只是一个控制台应用程序。该控制台应用程序使用宿主将应用程序转换为运行的服务，直到收到停止的信号。宿主带来了您可能已经熟悉的一些特性，比如依赖关系注入。使用和 asp.net core 中可用的相同的日志记录和配置扩展，使得开发可记录日志信息且需要一些配置的 worker service 变得相当轻松。当构建运行在云上的 worker service 时，几乎总会存在这种需求。例如，您可能需要为与您的 worker service 相交互的任何外部服务提供配置（比如一个队列 url）。

worker service 可用于从现有的 asp.net core 应用程序提取职责，设计新的基于 .net core 的微服务。

总结

在本文中，我介绍了 worker service 项目模板，以及它的一些潜在用例。我们探索了使用 worker service 模板创建的新项目中所包含的三个默认文件。

§worker service 模板包含哪些文件？

program.cs：控制台应用程序的入口点，创建并运行宿主以管理应用程序生命周期并生成一个长期运行的服务。
appsettings.json：一个提供应用程序配置值的 json 文件。
worker.cs：派生自backgroundservice基类，用于定义作为后台任务执行的长时间运行的工作负载。

§worker service 是什么？

不需要用户交互的应用程序。
使用宿主来维护控制台应用程序的生命周期，直到宿主收到关闭的信号。将控制台应用程序转换为长时间运行的服务。
包含和 asp.net core 相同的功能，如依赖注入、日志记录和配置。
执行定期和长时间运行的工作负载。

以上就是.net 中worker service的使用入门的详细内容，更多关于.net 中worker service的使用的资料请关注硕编程其它相关文章！

下一节：iis部署asp.net5的实现步骤

asp.net编程技术

C++实战