.NET Core配置通用主机

时间:2022-09-27 天方人气:0

ASP.NET Core 2.0 中的 WebHost（实现 IWebHost 的基类）是用于为进程提供 HTTP 服务器功能的基础结构项目，例如，如果正在实现 MVC Web 应用或 Web API 服务。它提供 ASP.NET Core 中所有新的基础结构优点，使用户能够使用依赖关系注入，在请求管道中插入中间件等，并精确地将这些 IHostedServices 用于后台任务。

.NET Core 2.1 中引入了 Host（实现 IHost 的基类）。它能让用户拥有与 WebHost相似的基础结构，使用它我们可以获取和Asp.net core一样的框架功能（依赖项注入、日志、配置、托管服务等），如果我们编写一个服务的时候，它提供了一个非常好用的框架。一个基本的示例代码如下：

public static async Task Main(string[] args)
{
    var host = new HostBuilder().Build();
    await host.RunAsync();
}

主要有如下两个步骤

通过HostBuilder生成一个Host
指向Host的Run函数运行主机

前面的代码只有一个空环境，要实现依赖项注入、日志、配置、托管服务等功能，还需要进一步的配置，本文的这里就简单的介绍一下通用主机的配置方法。

系统配置

系统配置有两个函数ConfigureHostConfiguration和ConfigureAppConfiguration

hostBuilder.ConfigureHostConfiguration(configHost =>
{
    configHost.SetBasePath(Directory.GetCurrentDirectory());
    configHost.AddJsonFile("hostsettings.json", optional: true);
    configHost.AddEnvironmentVariables(prefix: "PREFIX_");
    configHost.AddCommandLine(args);
});

这两个函数使用比较类似，它们的关系是主机配置用于初始化 IHostingEnvironment，以供在应用的构建过程中使用。

依赖关系注入

通用主机集成了DI框架，如果要使用DI框架，则需要调用ConfigureServices函数极限依赖关系注入：

hostBuilder.ConfigureServices((context, services) =>
{
    services.AddScoped<MyService>();
});

配置日志

我们可以通过在ConfigureServices中通过DI框架配置日志系统，但HostBuilder单独提供了一个配置日志的接口ConfigureLogging：

hostBuilder.ConfigureLogging((hostContext, configLogging) =>
{
    configLogging.AddConsole();
    configLogging.AddDebug();
});

它内部实际上依然是通过DI框架配置的日志系统。

通用配置

除了通过new一个HostBuilder外，系统还提供了一个创建HostBuilder的方法。

Host.CreateDefaultBuilder()

它的内部也是调用HostBuilder的，但他提供了一般常用的选项，具体包括：

将内容根设置为由 Directory.GetCurrentDirectory 返回的路径。
通过以下对象加载主机配置：
前缀为 DOTNET_ 的环境变量。（例如，DOTNET_ENVIRONMENT）。
命令行参数。
按以下顺序加载应用配置：
- appsettings.json。
- appsettings.{Environment}.json。
- 应用在使用入口程序集的 Development 环境中运行时的机密管理器。
- 环境变量。
- 命令行参数。
配置控制台和调试输出的日志记录。日志记录包含 appsettings.json 或 appsettings.{Environment}.json 文件的日志记录配置部分中指定的日志筛选规则。
如果应用环境为"开发"，请将 ServiceProviderOptions.ValidateScopes 设为 true。有关详细信息，请参阅作用域验证。

也就是说，它基本上提供了我们所常用的大部分功能，并且它返回的也是一个HostBuilder，我们还可以在它的基础上接着配置，实现我们系统中的特有功能

加载全部内容