ASP.NET?Core?5.0中的Host.CreateDefaultBuilder执行过程解析_应用技巧

来源:脚本之家  责任编辑:小易  
目录
ASP.NET Core 5.0中的Host.CreateDefaultBuilder执行过程一.创建默认主机Host.CreateDefaultBuilder1.创建主机构建器CreateHostBuilder(args)2.创建默认构建器Host.CreateDefaultBuilder(args)二.主机配置ConfigureHostConfiguration1.内存配置源2.环境变量配置源3.命令行配置源三.应用程序配置ConfigureAppConfiguration1.程序运行的主机环境2.加载json配置文件3.添加用户秘钥配置源四.日志配置ConfigureLogging1.Windows日志级别2.日志的配置3.ActivityTrackingOptions五.依赖注入配置UseDefaultServiceProvider

ASP.NET Core 5.0中的Host.CreateDefaultBuilder执行过程

通过Rider调试的方式看了下ASP.NET Core 5.0的Web API默认项目,重点关注Host.CreateDefaultBuilder(args)中的执行过程,主要包括主机配置、应用程序配置、日志配置和依赖注入配置这4个部分。由于水平和篇幅有限,先整体理解、建立框架,后面再逐步细化,对每个配置部分再详细拆解

一.创建默认主机Host.CreateDefaultBuilder

1.创建主机构建器CreateHostBuilder(args)

基于ASP.NET Core 5.0构建的Web API项目的Program.cs文件大家应该都很熟悉:

public class Program
{
    public static void Main(string[] args)
    {
        CreateHostBuilder(args).Build().Run();
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.UseStartup<Startup>();
            });
}

2.创建默认构建器Host.CreateDefaultBuilder(args)

本文重点讲解下Host.CreateDefaultBuilder(args)的执行过程,Microsoft.Extensions.Hosting.Host是一个静态类,包含2个方法:

public static IHostBuilder CreateDefaultBuilder() =>CreateDefaultBuilder(args: null);
public static IHostBuilder CreateDefaultBuilder(string[] args);

上面的方法最终调用的还是下面的方法,下面的方法主要包括几个部分:主机配置ConfigureHostConfiguration,应用程序配置ConfigureAppConfiguration,日志配置ConfigureLogging,依赖注入配置UseDefaultServiceProvider。

二.主机配置ConfigureHostConfiguration

主机配置ConfigureHostConfiguration相关源码如下:

builder.UseContentRoot(Directory.GetCurrentDirectory());
builder.ConfigureHostConfiguration(config =>
{
    config.AddEnvironmentVariables(prefix: "DOTNET_");
    if (args != null)
    {
        config.AddCommandLine(args);
    }
});

1.内存配置源

Directory.GetCurrentDirectory()当前目录指的就是D:\SoftwareProject\C#Program\WebApplication3\WebApplication3

2.环境变量配置源

config.AddEnvironmentVariables(prefix: "DOTNET_")添加了前缀为DOTNET_的环境变量。

3.命令行配置源

最开始认为参数args为null,经过调试发现args的值string[0],并且args != null,所以会有命令行配置源CommandLineConfigurationSource。

三.应用程序配置ConfigureAppConfiguration

应用程序配置ConfigureAppConfiguration相关源码如下:

builder.ConfigureAppConfiguration((hostingContext, config) =>
{
    IHostEnvironment env = hostingContext.HostingEnvironment;
    bool reloadOnChange = hostingContext.Configuration.GetValue("hostBuilder:reloadConfigOnChange", defaultValue: true);

    config.AddJsonFile("appsettings.json", optional: true, reloadOnChange: reloadOnChange).AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true, reloadOnChange: reloadOnChange);

    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);
    }
})

1.程序运行的主机环境

hostingContext.HostingEnvironment表示运行程序的主机环境,比如开发环境或者生产环境。IHostEnvironment接口的数据结构为:

public interface IHostEnvironment
{
    // Development
    string EnvironmentName { get; set; }
    // WebApplication3
    string ApplicationName { get; set; }
    // D:\SoftwareProject\C#Program\WebApplication3\WebApplication3
    string ContentRootPath { get; set; }
    // PhysicalFileProvider
    IFileProvider ContentRootFileProvider { get; set; }
}

2.加载json配置文件

接下来就是通过AddJsonFile()来添加配置文件了,如下所示:
(1)Path(string):json文件的相对路径位置。
(2)Optional(bool):指定文件是否是必须的,如果为false,那么如果找不到文件就会抛出文件找不到异常。
(3)ReloadOnchange(bool):如果为true,那么当改变配置文件,应用程序也会随之更改而无需重启。
在该项目中总共有2个配置文件,分别是appsettings.json和appsettings.Development.json。

3.添加用户秘钥配置源

config.AddUserSecrets(appAssembly, optional: true)主要是在开发的过程中,用来保护配置文件中的敏感数据的,比如密码等。因为平时在开发中很少使用,所以在此不做深入讨论,如果感兴趣可参考[3]。

四.日志配置ConfigureLogging

日志配置ConfigureLogging相关源码如下:

.ConfigureLogging((hostingContext, logging) =>
{
    bool isWindows = RuntimeInformation.IsOSPlatform(OSPlatform.Windows);
    if (isWindows)
    {
        // Default the EventLogLoggerProvider to warning or above
        logging.AddFilter<EventLogLoggerProvider>(level => level >= LogLevel.Warning);
    }

    logging.AddConfiguration(hostingContext.Configuration.GetSection("Logging"));
    logging.AddConsole();
    logging.AddDebug();
    logging.AddEventSourceLogger();

    if (isWindows)
    {
        // Add the EventLogLoggerProvider on windows machines
        logging.AddEventLog();
    }

    logging.Configure(options =>
    {
        options.ActivityTrackingOptions = ActivityTrackingOptions.SpanId
                                            | ActivityTrackingOptions.TraceId
                                            | ActivityTrackingOptions.ParentId;
    });
})

1.Windows日志级别

从上述代码中可以看到是LogLevel.Warning及以上。

2.日志的配置

ILoggerProvider不同的实现方式有:ConsoleLoggerProviderDebugLoggerProviderEventSourceLoggerProviderEventLogLoggerProviderTraceSourceLoggerProvider自定义。下面是日志配置涉及的相关代码:

logging.AddConsole(); //将日志输出到控制台
logging.AddDebug(); //将日志输出到调试窗口
logging.AddEventSourceLogger();
logging.AddEventLog();

说明:这一部分详细的日志分析可以参考[6]。

3.ActivityTrackingOptions

public enum ActivityTrackingOptions
{
  None = 0, //No traces will be included in the log
  SpanId = 1, //The record will contain the Span identifier
  TraceId = 2, //The record will contain the tracking identifier
  ParentId = 4, //The record will contain the parent identifier
  TraceState = 8, //The record will contain the tracking status
  TraceFlags = 16, //The log will contain trace flags
}

在最新的.NET 7 Preview6中又增加了Tags(32)和Baggage(64)。

五.依赖注入配置UseDefaultServiceProvider

依赖注入配置UseDefaultServiceProvider相关源码如下:

.UseDefaultServiceProvider((context, options) =>
{
    bool isDevelopment = context.HostingEnvironment.IsDevelopment();
    options.ValidateScopes = isDevelopment;
    options.ValidateOnBuild = isDevelopment;
});

UseDefaultServiceProvider主要是设置默认的依赖注入容器。

参考文献:
[1].NET Source Browser:https://source.dot.net/
[2]Safe storage of app secrets in development in ASP.NET Core:https://docs.microsoft.com/en-us/aspnet/core/security/app-secrets?view=aspnetcore-6.0&tabs=windows
[3]认识ASP.NET Core/Host及其配置解析:https://zhuanlan.zhihu.com/p/343312339
[4]源码解析.Net中Host主机的构建过程:https://www.cnblogs.com/snailZz/p/15240616.html
[5].NET Core通用Host源码分析:https://www.cnblogs.com/yingbiaowang/p/15048495.html
[6]基于.NetCore3.1系列--日志记录之日志配置揭秘:https://www.cnblogs.com/i3yuan/p/13411793.html
[7]基于.NetCore3.1系列--日志记录之日志核心要素揭秘:https://www.cnblogs.com/i3yuan/p/13442509.html
[8].NET5中Host.CreateDefaultBuilder(args)详解:https://blog.csdn.net/qbc12345678/article/details/122983855
[9]ASP.NET启动和运行机制:https://www.jianshu.com/p/59cfaba4e2cb
[10]ASP.Net Core解读通用主机和托管服务:https://www.cnblogs.com/qtiger/p/12976207.html

到此这篇关于ASP.NET Core 5.0中的Host.CreateDefaultBuilder执行过程解析的文章就介绍到这了,更多相关ASP.NET Core 5.0 Host.CreateDefaultBuilder执行过程内容请搜索真格学网以前的文章或继续浏览下面的相关文章希望大家以后多多支持真格学网!

您可能感兴趣的文章:在ASP.NET Core5.0中访问HttpContext的方法步骤从ASP.NET Core3.1迁移到5.0的方法ASP.NET?Core中的通用主机HostBuilder如何在ASP.Net Core中使用 IHostedService的方法ASP.NET Core使用HostingStartup增强启动操作方法详解

  • 本文相关:
  • asp+access通用的自动替换数据库中的字符串
  • asp实现网页打开任何类型文件都提示保存的方法附代码
  • 防止网站内容被小偷采集的asp代码
  • asp google pr查询代码
  • asp读取xml实例 优酷专辑采集程序 雷锋版
  • 让 asp 与 xml 交互
  • 用asp实现在线压缩与解压缩功能代码
  • 冒泡算法的三种javascript表示
  • ajax xmlhttp post form时的表单乱码综合解决
  • asp有效防止网站留言板出现垃圾留言/评论实现思路
  • 网站首页网页制作脚本下载服务器操作系统网站运营平面设计媒体动画电脑基础硬件教程网络安全asp基础应用技巧数据库相关asp class类存储过程小偷/采集木马相关fso专题首页asp编程应用技巧在asp.net core5.0中访问httpcontext的方法步骤从asp.net core3.1迁移到5.0的方法asp.net?core中的通用主机hostbuilder如何在asp.net core中使用 ihostedservice的方法asp.net core使用hostingstartup增强启动操作方法详解asp+access通用的自动替换数据库中的字符串asp实现网页打开任何类型文件都提示保存的方法附代码防止网站内容被小偷采集的asp代码asp google pr查询代码asp读取xml实例 优酷专辑采集程序 雷锋版让 asp 与 xml 交互用asp实现在线压缩与解压缩功能代码冒泡算法的三种javascript表示ajax xmlhttp post form时的表单乱码综合解决asp有效防止网站留言板出现垃圾留言/评论实现思路推荐4款傻瓜型的asp服务器软件(asp运行环境一键搭建工具关于“未指定的错误”的问题 的比较正解的解决方法错误类型:provider (0x80004005)未指定的c#入门教程之listbox控件使用方法utf-8 网页不显示+utf-8网页乱码的通用解决方法asp 日期格式化问题asp中设置session过期时间方法总结microsoft jet database engine(sql查询语句通配符与access模糊查询like的解决方法asp随机数rnd()使用方法asp下如何在ado服务器端利用好缓存技术?关于asp代码的加密的几个方法replacetrim 函数之asp实现过滤掉字符中所有的tab和回车和换行用quickwap组件结合asp建设wap站点asp又一个分页的代码例子服务端 vbscript 与 jscript 几个相同特性的写法与示例asp生成数字相加求和的bmp图片验证码asp conn.execute的参数与返回值总结asp中用select case代替其他语言中的switch case, dasp网站出现 msxml3.dll 错误 80072ee7 错误的解决方
    免责声明 - 关于我们 - 联系我们 - 广告联系 - 友情链接 - 帮助中心 - 频道导航
    Copyright © 2017 www.zgxue.com All Rights Reserved