在.NET Core中,Host负责应用程序的启动和生命周期管理。除此之外,在Host中还可以设置日志(Logging)、配置(Configuration)和依赖关系注入(Dependency Injection)等。Host将一个常规的控制台应用程序(Console Application)变成了一个可以长时间运行的服务(Long-running Service)。
Hosting History
在.NET Core中,有以下2个Host:
.NET Generic Host(简称 Generic Host)
ASP.NET Core Web Host(简称 Web Host)
要了解它们之间的区别与联系,我们需要从.NET Core的发展历程中寻找答案。
微软在2016年6月发布了.NET Core 1.0
。.NET Core是一个开放的、支持跨平台的框架,它与.NET Framework有着显著的不同。在这之后微软又陆续发布了.NET Core 1.1
、.NET Core 2.0
、.NET Core 2.1
、.NET Core 2.2
、.NET Core 3.0
和.NET Core 3.1
。
Web Host在.NET Core 1.0
中被引入,它被用于配置并启动Kestrel
Web服务器,在指定的端口上监听HTTP请求。Web Host正如它的名称所言,只用于Host ASP.NET Core Web Application。
Generic Host在.NET Core 2.1
中被引入,但它只被用于non-HTTP的场景,例如hosted services/worker services。此时你仍需要使用Web Host来Host ASP.NET Core Web Application。这带来了一定的混淆和麻烦,很多相近的类被引入。
IWebHost 与 IHost,IWebHostBuilder与IHostBuilder
Interface | Namespace | Default Implementation | Git Repo | Source Code |
---|---|---|---|---|
IWebHost | Microsoft.AspNetCore.Hosting | WebHost | https://github.com/dotnet/aspnetcore | src/Hosting/Hosting/src/Internal/WebHost.cs |
IHost | Microsoft.Extensions.Hosting | Host | https://github.com/dotnet/runtime | src/libraries/Microsoft.Extensions.Hosting/src/Internal/Host.cs |
IWebHostBuilder | Microsoft.AspNetCore.Hosting | WebHostBuilder | https://github.com/dotnet/aspnetcore | src/Hosting/Hosting/src/WebHostBuilder.cs |
IHostBuilder | Microsoft.Extensions.Hosting | HostBuilder | https://github.com/dotnet/runtime | src/libraries/Microsoft.Extensions.Hosting/src/HostBuilder.cs |
还有与这些接口相关的静态辅助类:
Class | Namespace | Git Repo | Source Code |
---|---|---|---|
WebHost | Microsoft.AspNetCore | https://github.com/dotnet/aspnetcore | src/DefaultBuilder/src/WebHost.cs |
Host | Microsoft.Extensions.Hosting | https://github.com/dotnet/runtime | src/libraries/Microsoft.Extensions.Hosting/src/Host.cs |
我们在Program.cs
文件中一般都是用这两个静态辅助类来创建IWebHost或IHost的具体实例,进而启动应用程序。
IHostingEnvironment vs IHostEnvironment vs IWebHostEnvironment
这几个接口是不是傻傻分不清?这其实充分说明了微软在主导.NET Core的开发过程中存在着管理和命名的混乱。这也难免,毕竟这么大的项目,而且代码库也是各管各的。
首先IHostingEnvironment存在于2个不同的命名空间中,虽然接口内容大致相同,但却是互不兼容的——它们之间没有继承关系。
Interface | Namespace | Git Repo | Source Code |
---|---|---|---|
IHostingEnvironment | Microsoft.AspNetCore.Hosting | https://github.com/dotnet/aspnetcore | src/Hosting/Abstractions/src/IHostingEnvironment.cs |
IHostingEnvironment | Microsoft.Extensions.Hosting | https://github.com/dotnet/runtime | src/libraries/Microsoft.Extensions.Hosting.Abstractions/src/IHostingEnvironment.cs |
从.NET Core 3.0起,这两个接口都被标记为obsolete
,取而代之的分别是IWebHostEnvironment 与 IHostEnvironment。它们依然存在于不同的命名空间中,但它们之间有了继承关系。
Interface | Namespace | Git Repo | Source Code |
---|---|---|---|
IWebHostEnvironment | Microsoft.AspNetCore.Hosting | https://github.com/dotnet/aspnetcore | src/Hosting/Abstractions/src/IWebHostEnvironment.cs |
IHostEnvironment | Microsoft.Extensions.Hosting | https://github.com/dotnet/runtime | src/libraries/Microsoft.Extensions.Hosting.Abstractions/src/IHostEnvironment.cs |
|
|
这样的设计就很合理,也减少了重复。它们各自的默认实现也基本相同。
Default Implementation | Namespace | Git Repo | Source Code |
---|---|---|---|
HostingEnvironment | Microsoft.AspNetCore.Hosting | https://github.com/dotnet/aspnetcore | src/Hosting/Hosting/src/Internal/HostingEnvironment.cs |
HostingEnvironment | Microsoft.Extensions.Hosting.Internal | https://github.com/dotnet | src/libraries/Microsoft.Extensions.Hosting/src/Internal/HostingEnvironment.cs |
|
|
Generic Host 取代 Web Host
时间来到了.NET Core 3.0发布。微软重构了Generic Host,使之成为一个真正的通用的Host——可同时运行Worker Services和Web Applications。这大大简化了Host的模型及相关的类,开发者理解和使用起来更加容易了。
图片来自PluralSight课程
小结
尽可能地使用
IHostEnvironment
官方不建议在.NET Core 3.0及以上的版本中使用Web Host
对于ASP.NET Core Web Application来说,Kestrel Web Server被包装在GenericWebHostService中被Generic Host初始化并启动
微软于2020年11月发布了
.NET 5
。.NET 5
是.NET Core的下一个版本,被描述为.NET统一之旅中的第一个版本,它是为了使更多的开发人员能够将.NET框架代码和应用迁移到.NET 5
。该平台将来自.NET Framework、.NET Core和Mono的代码组合在一起,为所有现代.NET应用提供一个单一的平台。本文所讨论的.NET Generic Host
同样适用于.NET 5
。
CreateDefaultBuilder与ConfigureWebHostDefaults
一般情况下,我们使用静态辅助类Host
中的CreateDefaultBuilder
方法来创建IHostBuilder
的实例。对于ASP.NET Core Web Application,我们还会调用ConfigureWebHostDefaults
方法。我们需要了解这两个方法到底做了哪些默认的设置,以便减少不必要、多余的设置。
CreateDefaultBuilder 方法
将内容根目录设置为由 GetCurrentDirectory 返回的路径
通过以下项加载主机配置:
前缀为 DOTNET_ 的环境变量
命令行参数
通过以下项加载应用配置:
appsettings.json
appsettings.{Environment}.json
在 Development 环境中运行时的用户机密配置信息(secrets.json)
环境变量
命令行参数
添加以下日志提供程序:
控制台
调试
EventSource
EventLog(仅当在 Windows 上运行时)
在 Development 环境中,启用范围验证和依赖关系验证
图片来自PluralSight课程
ConfigureWebHostDefaults 方法
从前缀为 ASPNETCORE_ 的环境变量加载主机配置。
使用应用的托管配置提供程序将 Kestrel 服务器设置为 web 服务器并对其进行配置。
如果 ASPNETCORE_FORWARDEDHEADERS_ENABLED 等于 true,则添加转接头中间件(ForwardedHeadersStartupFilter)。
添加 IIS 集成。
推荐阅读源代码了解更多的实现细节
CreateDefaultBuilder
ConfigureDefaults
ConfigureWebHostDefaults
GenericWebHostBuilder
ConfigureWebDefaults
ConfigureWebHost
Generic Host 的启动与停止
启动
Generic Host 的启动步骤如下:
在
Program.cs
文件中,通过CreateDefaultBuilder
构建一个IHost
的实例调用
IHost
上的静态扩展方法Run或RunAsync,这会间接调用到IHost
的StartAsync
方法IHost
的StartAsync方法则会遍历所有注册的IHostedService
,调用它的StartAsync
方法IHost
上的静态扩展方法[Run或RunAsync]会调用另一个扩展方法——WaitForShutdownAsync,等待程序结束的信号
图片来自PluralSight课程
.NET Core 应用程序运行后会创建名为.NET Host(dotnet.exe)
的后台进程。
停止
Generic Host 的停止步骤如下:
用户使用Ctrl + C或者应用程序使用代码来发出程序结束的信号
IHost
的StopAsync方法在WaitForShutdownAsync
中被调用所有注册的
IHostedService
的StopAsync
方法被调用应用程序退出
图片来自PluralSight课程
需要指出的是,IHostedService
的注册顺序是非常重要的,启动的时候是按注册顺序,停止的时候则是倒序。
其它的Host
在Windows操作系统中,你还会看到很多其它的Host。
Console Window Host(conhost.exe)
Console Window Host, 即命令行程序的宿主进程。典型的命令行程序有cmd.exe、nslookup.exe等。Console Window Host负责绘制命令行程序的图形化窗口,管理输入缓冲区
和屏幕缓冲区
。
Service Host(svchost.exe)
Service Host是一个共有的宿主进程的名称,它用来运行DLL文件中的服务,特别是很多系统服务。为了使这些服务之间保持隔离,减少相互影响导致的程序错误,系统会运行很多个Service Host的进程实例。你可以使用Process Explorer这个工具,通过Command Line
列来区分它们。
DLL Host(dllhost.exe)
DLL Host程序又称为COM Surrogate
,它是COM组件的宿主进程。COM(Component Object Model,组件对象模型)是微软于1993年提出的一种软件开发技术,它定义了组件对象进行交互的二进制接口标准。COM组件大多以动态链接库(DLL)的形式发布,DLL Host(dllhost.exe)则正是加载这些COM组件的宿主程序。与Service Host类似,系统会运行很多个DLL Host的进程实例。你可以使用Process Explorer这个工具,通过Command Line
列来区分它们。
参考资料
ASP.NET Core Web Host
.NET Generic Host in ASP.NET Core
Building ASP.NET Core Hosted Services and .NET Core Worker Services
Introducing .NET Core
Announcing .NET Core 1.0
Announcing .NET 5.0
Understanding .NET Generic Host Model
Generic Host Builder in ASP .NET Core 3.1
Changes to Service Host grouping in Windows 10