我心中的ASP.NET Core 新核心对象WebHost（一）

爱被打了一巴掌 2021-11-01 11:32 252阅读 0赞

以本系列文章向Fish 前辈的那篇 [我心中的ASP.NET 核心对象][ASP.NET] 致敬。（虽然不知道前辈现在在干什么）。一晃就6年过去了，那首  郝云 的《回到那一天》怎么唱来着？ 时光一晃，你就三十了。

而我们都变成了老了的程序员 ?

ASP.NET Core在解开了对windows的依懒之后，整个管线都发生了变化 。这个变化是彻底的，原来ASP.NET 中的有些对象直接没有了。被保留下来的，也只是你看起来还差不多，但实现已经完全不一样了。

我们就来说说我认为的这些ASP.NET Core的这些新的核心对象。

WebHost，  IServiceCollection，IServiceProvider，IApplicationBuilder，IMiddleware 和 RequestDelegate， IServer和IHttpApplication ，

还有一些同样很重要的对象： ILogger, IConfiguration

### 始于WebHost ###

WebHost像母亲，它承载和孕育了ASP.NET Core下几乎所有的对象，从代码层面入手来看的话可以说是ASP.NET Core的入口，没有它，后面的一切都没有办法开始。当然如何复杂的一项业务，要做好也不容易，WebHost的启动一共分为四阶段。

*  准备阶段： var builder = new WebHostBuilder()，然后给WebHostBuilder各种填参数
 *  构建阶段： var host = builder.Builder() ， 主要负责依懒注入的初始化，以及host的初始化
 *  启动阶段： host.start(); 
 *  运行阶段

### program.cs ###

ASP.NET Core 程序基于一个命令行的程序运行，程序的入口在program.cs的main方法。

public static void Main(string[] args)
    {
        WebHost.CreateDefaultBuilder(args)
            .UseStartup<Startup>()
            .Build()
            .Run();
    }

WebHost是一个internal类，我相信NETCore团队不希望大家随意的去new它，而是通过WebHostBuilder去构建。我们在这里访问的WebHost实际上不是真正的WebHost，真正的WebHost在github的Hosting项目下，命名空间为：Microsoft.AspNetCore.Hosting.Internal。

在ASP.NET Core1x中，我们必须要自己创建WebHostBuilder。

var host = new WebHostBuilder()
                    .UseKestrel()
                    .UseContentRoot(Directory.GetCurrentDirectory())
                    .UseIISIntegration()
                    .UseStartup<Startup>()
                    .Build();

这些默认的动作未免有些繁琐，后来到了ASP.NET Core2的时候创建了一个新的项目在github上，叫做MetaPackages 并在 Microsoft.AspNetCore的命名空间下创建了一个static class也就是我们现在用到的这个，里面主要的方法就是CreateDefaultBuilder。

### CreateDefaultBuilder方法 ###

这个方法负责返回给我们一个WebHostBuilder， 并且调用了以下扩展方法：

*  UseKestrel 使用kestrel server来处理请求
 *  UseContentRoot 设置站点目录
 *  ConfigureAppConfiguration
 *  ConfigureLogging

其实和我们在1X的时候自己构建是一个道理，而这些都是基于WebHostBuilder 的扩展方法它们来自于其它几个不同的组件。

### UseKestrel ###

WebHost负责托管ASP.NET Core，但是它并不真正从服务器网卡上监听端口以及将网络字节转换到.net core的管道。这些由IServer来处理。

![webhost.png][]

这里先简单了解一下这个过程，我们后面会在IServer的环节再详述。我们这里使用的UseKestrel 来自于github上的项目 KestrelHttpServer。

里面的Kestrel项目下有一个WebHostBuilderKestrelExtensions类。里面就是这个 UseKestrel扩展方法的定义：

public static IWebHostBuilder UseKestrel(
        this IWebHostBuilder hostBuilder)
    {
        return hostBuilder.ConfigureServices(services =>
        {
        // Don't override an already-configured transport
        services.TryAddSingleton<
            ITransportFactory, 
            SocketTransportFactory>();
    
        services.AddTransient<
            IConfigureOptions<KestrelServerOptions>, 
            KestrelServerOptionsSetup>();
    
        services.AddSingleton<
            IServer, 
            KestrelServer>();
        });
    }

其实也很简单，都是在进行Server依赖的配置，因为最终的执行都由WebHost来展控。所以WebHost大量依赖的其它外部组件都被定义成接口放到了HttpAbstractions里面，然后由外部扩展方法（多以Use开头，进行配置）

![webhost02.png][]

ASP.NET Core源码里面大量使用扩展方法进行Servier DI的配置，扩展方法定义在各种不同的命名空间以及项目下。如果不习惯或者不了解相关的部分会觉得有些痛苦。

### ConfigureAppConfiguration ###

这个方法专门用来为 WebHostBuilder添加配置，包括appsettings.json的、命令行参数以及环境变量。关于配置这一节我们留在后面具体来讲。

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

### ConfigureLogging ###

logging也是 ASP.NET Core内置组件中的很重要一个，这个方法在默认已经为我们添加了appsettings中的logging配置以及控制台log。关于日志这一节我们留在后面具体来讲。

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

### UseStartup<> ###

Startup.cs这个类主要做两件事情的配置Service DI和http管道，这些都是在WebHost启动之前就需要确定下来的。而UseStartup就是将我们定义的Startup.cs和 IStartup绑定起来，让WebHost可以找得到。 怎么绑定呢？ 当然还是依赖注入：

if (typeof(IStartup)
         .GetTypeInfo()
         .IsAssignableFrom(startupType.GetTypeInfo()))
    {
        services.AddSingleton(typeof(IStartup), startupType);
    }
    else
    {
        services.AddSingleton(typeof(IStartup), sp =>
        {
        var hostingEnvironment = 
        sp.GetRequiredService<IHostingEnvironment>();
    
        return new ConventionBasedStartup(
        StartupLoader.LoadMethods(
             sp, 
             startupType, 
             hostingEnvironment.EnvironmentName));
        });
    }

VS为我们添加的Startup.cs默认不继续IStartup接口，所以是采用Convention的这种方式，当然我们也可以继承IStartup则直接注册成单例到应用程序。

以上是整个 WebHostBuilder的准备阶段，即往里面放了很多的参数。下一篇我们将接着讲Builder阶段，给了你那么多，你要开始制造点什么东西给我了。

![qrcode_for_gh_e59d348bb37b_430-1-300x300.jpg][]

本文首发于公众号jessetalk，转载请保留公众号二维码。

分类： [技术随笔][Link 1]

标签： [asp.net core][]

[  ][Link 2] [  ][Link 3] [  ][Link 4]

--------------------

### 6 条评论 ###

![f411333bb368ceaf818f5508ff52d8f8_s_64_d_mm_r_g][]

#### zhang  · 2017年11月25日 下午1:06  ####

支持

[ 回复][Link 5]

![f411333bb368ceaf818f5508ff52d8f8_s_64_d_mm_r_g][]

#### fei  · 2017年11月25日 下午1:07  ####

评论加邮箱是否有些多余

[ 回复][Link 6]

![81f3239c76546152d7923827f8ec60a7_s_64_d_mm_r_g][]

#### [码农阿宇][Link 7]  · 2017年12月14日 下午10:06  ####

感谢腾飞写了这么好的文章，已经转发并注明了来源并且保留了公众号二维码 谢谢

[ 回复][Link 8]

![406df5d18f85113f472a34338b7a3e2a_s_64_d_mm_r_g][]

#### [Chain][]  · 2017年12月29日 上午9:19  ####

已学习。

[ 回复][Link 9]

![684affc299886e4c79a950d7e452733d_s_64_d_mm_r_g][]

#### Allen  · 2018年2月27日 下午2:37  ####

感谢

[ 回复][Link 10]

![1e829da830eff83c2ef172c799d7010d_s_64_d_mm_r_g][]

#### Jay  · 2018年7月16日 下午6:13  ####

支持，感谢

[ 回复][Link 11]

### 发表评论 取消回复 ###

![placeholder.jpg][]

电子邮件地址不会被公开。 必填项已用\*标注

名称 \*

电子邮件 \*

网站

在想些什么？

转载于:https://www.cnblogs.com/owenzh/p/11306961.html

[ASP.NET]: https://www.cnblogs.com/fish-li/archive/2011/08/21/2148640.html
[webhost.png]: http://www.jessetalk.cn/wp-content/uploads/2017/11/webhost.png
[webhost02.png]: http://www.jessetalk.cn/wp-content/uploads/2017/11/webhost02.png
[qrcode_for_gh_e59d348bb37b_430-1-300x300.jpg]: http://www.jessetalk.cn/wp-content/uploads/2017/09/qrcode_for_gh_e59d348bb37b_430-1-300x300.jpg
[Link 1]: http://www.jessetalk.cn/category/tech/
[asp.net core]: http://www.jessetalk.cn/tag/asp-net-core/
[Link 2]: https://www.facebook.com/sharer.php?u=http://www.jessetalk.cn/2017/11/11/aspnet-core-object-webhost/
[Link 3]: http://twitter.com/share?url=http://www.jessetalk.cn/2017/11/11/aspnet-core-object-webhost/&text=%E6%88%91%E5%BF%83%E4%B8%AD%E7%9A%84ASP.NET%20Core%20%E6%96%B0%E6%A0%B8%E5%BF%83%E5%AF%B9%E8%B1%A1WebHost%EF%BC%88%E4%B8%80%EF%BC%89
[Link 4]: mailto:?subject=%E6%88%91%E5%BF%83%E4%B8%AD%E7%9A%84ASP.NET%20Core%20%E6%96%B0%E6%A0%B8%E5%BF%83%E5%AF%B9%E8%B1%A1WebHost%EF%BC%88%E4%B8%80%EF%BC%89&body=http://www.jessetalk.cn/2017/11/11/aspnet-core-object-webhost/
[f411333bb368ceaf818f5508ff52d8f8_s_64_d_mm_r_g]: http://0.gravatar.com/avatar/f411333bb368ceaf818f5508ff52d8f8?s=64&d=mm&r=g
[Link 5]: http://www.jessetalk.cn/2017/11/11/aspnet-core-object-webhost/?replytocom=13#respond
[Link 6]: http://www.jessetalk.cn/2017/11/11/aspnet-core-object-webhost/?replytocom=14#respond
[81f3239c76546152d7923827f8ec60a7_s_64_d_mm_r_g]: http://2.gravatar.com/avatar/81f3239c76546152d7923827f8ec60a7?s=64&d=mm&r=g
[Link 7]: http://www.liuzhenyu.xin
[Link 8]: http://www.jessetalk.cn/2017/11/11/aspnet-core-object-webhost/?replytocom=18#respond
[406df5d18f85113f472a34338b7a3e2a_s_64_d_mm_r_g]: http://1.gravatar.com/avatar/406df5d18f85113f472a34338b7a3e2a?s=64&d=mm&r=g
[Chain]: http://www.chairis.cn
[Link 9]: http://www.jessetalk.cn/2017/11/11/aspnet-core-object-webhost/?replytocom=23#respond
[684affc299886e4c79a950d7e452733d_s_64_d_mm_r_g]: http://0.gravatar.com/avatar/684affc299886e4c79a950d7e452733d?s=64&d=mm&r=g
[Link 10]: http://www.jessetalk.cn/2017/11/11/aspnet-core-object-webhost/?replytocom=28#respond
[1e829da830eff83c2ef172c799d7010d_s_64_d_mm_r_g]: http://1.gravatar.com/avatar/1e829da830eff83c2ef172c799d7010d?s=64&d=mm&r=g
[Link 11]: http://www.jessetalk.cn/2017/11/11/aspnet-core-object-webhost/?replytocom=194#respond
[placeholder.jpg]: http://www.jessetalk.cn/wp-content/themes/hestia/assets/img/placeholder.jpg