.NET Core 3.0 之初识Host源码
写在前面
ASP .NET Core中的通用主机构建器是在v2.1中引入的,应用在启动时构建主机,主机作为一个对象用于封装应用资源以及应用程序启动和生存期管理。其主要功能包括配置初始化(包括加载配置以及配置转换为通用的键值对格式),创建托管环境和Host通用上下文、依赖注入等。
在.NET Core 3.0中采用了IHostBuilder用于创建Host,同时也不再建议使用Web主机,而建议使用泛型主机,主要原因是原有的通用主机仅适用于非HTTP负载,为了提供更加广泛的主机方案,需要将HTTP管道与Web主机的接口分离出来。但Web主机仍会向后兼容。
.NET Core 3.0中创建通用主机
以下代码是V3.0中提供的模板代码,可以看到在创建主机的过程中,已经摒弃了WebHostBuilder的创建方式
public class Program[code]{
public static void Main(string[] args)
{
CreateHostBuilder(args).Build().Run();
}
public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
.ConfigureWebHostDefaults(webBuilder =>
{
webBuilder.UseStartup<Startup>();
});
}[/code]
而在.NET Core 2.X中
public class Program[code]{
public static void Main(string[] args)
{
CreateWebHostBuilder(args).Build().Run();
}
public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
WebHost.CreateDefaultBuilder(args)
.UseStartup<Startup>();
}[/code]
V3.0模板中提供的CreateHostBuilder()方法看起来非常类似于V2.X中的CreateWebHostBuilder()。
其主要区别在于对WebHost.CreateDefaultBuilder()由Host.CreateDefaultBuilder()替换。使用CreateDefaultBuilder()辅助方法可以非常轻松地从v2.x切换到v3.0。
另一个区别是关于ConfigureWebHostDefaults()的调用。由于新的主机构建器是通用主机构建器,因此我们必须让它知道我们打算为Web主机配置默认设置。这些默认配置我们可以在ConfigureWebHostDefaults()方法中实现
CreateDefaultBuilder
该方法Microsoft.Extensions.Hosting.Host中,它是一个静态类,里面有两个方法,一个有参的CreateDefaultBuilder(string[] args),一个是无参的。
无参方法源码如下,
[/code]public static IHostBuilder CreateDefaultBuilder() =>[code] CreateDefaultBuilder(args: null);
可以看到该方法实际上是设置了默认值。
IHostBuilder CreateDefaultBuilder(string[] args)方法主要有以下功能:
创建HostBuilder对象
var builder = new HostBuilder();
指定Host要使用的内容根目录
builder.UseContentRoot(Directory.GetCurrentDirectory());
配置初始化(环境变量、appsettings.json、User Secrets)
builder.ConfigureHostConfiguration(config =>[code]{
config.AddEnvironmentVariables(prefix: "DOTNET_");
if (args != null)
{
config.AddCommandLine(args);
}
});
builder.ConfigureAppConfiguration((hostingContext, config) =>
{
var env = hostingContext.HostingEnvironment;
config.AddJsonFile("appsettings.json", optional: true, reloadOnChange: true)
.AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true, reloadOnChange: true);
if (env.IsDevelopment() && !string.IsNullOrEmpty(env.ApplicationName))
{
var appAssembly = Assembly.Load(new AssemblyName(env.ApplicationName));
if (appAssembly != null)
{
config.AddUserSecrets(appAssembly, optional: true);
}
}
config.AddEnvironmentVariables();
if (args != null)
{
config.AddCommandLine(args);
}
})[/code]
日志
.ConfigureLogging((hostingContext, logging) =>[code]{
logging.AddConfiguration(hostingContext.Configuration.GetSection("Logging"));
logging.AddConsole();
logging.AddDebug();
logging.AddEventSourceLogger();
})[/code]
在开发环境模式下启用作用域验证
.UseDefaultServiceProvider((context, options) =>[code]{
var isDevelopment = context.HostingEnvironment.IsDevelopment();
options.ValidateScopes = isDevelopment;
options.ValidateOnBuild = isDevelopment;
});[/code]
Build
Build()方法是Microsoft.Extensions.Hosting中,并且该方法只会执行一次,当然这种一次只是在同一个实例里面
public IHost Build()[code]{
if (_hostBuilt)
{
throw new InvalidOperationException("Build can only be called once.");
}
_hostBuilt = true;
BuildHostConfiguration();
CreateHostingEnvironment();
CreateHostBuilderContext();
BuildAppConfiguration();
CreateServiceProvider();
return _appServices.GetRequiredService<IHost>();
}[/code]
该方法主要是包括以下功能:
创建HostingEnvironment
创建HostBuilderContext
配置初始化及格式标准化
DI(创建IHostEnvironment、IHostApplicationLifetime、IHostLifetime、IHost)
Run
Run方法运行应用程序并阻止调用线程,直到主机关闭
public static void Run(this IHost host)[code]{
host.RunAsync().GetAwaiter().GetResult();
}[/code]
以下是RunAsync的源码,此处可以通过设置CancellationToken的值,使应用程序自动关闭
public static async Task RunAsync(this IHost host, CancellationToken token = default)[code]{
try
{
await host.StartAsync(token);
await host.WaitForShutdownAsync(token);
}
finally
{
#if DISPOSE_ASYNC
if (host is IAsyncDisposable asyncDisposable)
{
await asyncDisposable.DisposeAsync();
}
else
#endif
{
host.Dispose();
}
}
}[/code]
- .Net Core 中间件之主机地址过滤(HostFiltering)源码解析
- .NET Core 3.0之深入源码理解Configuration(二)
- .NET Core 3.0之深入源码理解Configuration(三)
- .NET Core 3.0之深入源码理解Configuration(一)
- Orchard源码分析(5.1):Host初始化(DefaultOrchardHost.Initialize方法)
- AFNetworking 3.0 源码解读(八)之 AFImageDownloader
- windows 64位编译hadoop 3.0源码
- Linux内核源码分析--内核启动之(1)zImage自解压过程(Linux-3.0 ARMv7)
- EventBus 3.0 从入门到精通——初识EventBus
- 【cocos2d-x 3.0】入门样例《SimpleGame》源码解读【1】
- WangSql 3.0源码共享(WangSql 1.0重大升级到3.0)
- hystrix线程池隔离源码初识
- MVP源码实战解析——告别MVC,初识MVP
- 初识 EXT3.0 中的 chart
- .Net Core缓存组件(Redis)源码解析
- zabbix3.0源码安装
- Spring Security源码分析十:初识Spring Security OAuth2
- python 3.0学习笔记之一------初识python
- jquery3.0源码解读(四)Callbacks
- ASP.NET MVC 3.0 参考源码索引