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

以本系列文章向Fish 前輩的那篇我心中的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來處理。

這里先簡單了解一下這個過程，我們后面會在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&lt;
    IConfigureOptions&lt;KestrelServerOptions&gt;, 
    KestrelServerOptionsSetup&gt;();

services.AddSingleton&lt;
    IServer, 
    KestrelServer&gt;();
});

}

其實也很簡單，都是在進行Server依賴的配置，因為最終的執行都由WebHost來展控。所以WebHost大量依賴的其它外部組件都被定義成接口放到了HttpAbstractions里面，然后由外部擴展方法（多以Use開頭，進行配置）

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>();
<span class="hljs-keyword">return</span> <span class="hljs-keyword">new</span> ConventionBasedStartup(
StartupLoader.LoadMethods(
     sp, 
     startupType, 
     hostingEnvironment.EnvironmentName));
});

}

VS為我們添加的Startup.cs默認不繼續IStartup接口，所以是采用Convention的這種方式，當然我們也可以繼承IStartup則直接注冊成單例到應用程序。

以上是整個 WebHostBuilder的准備階段，即往里面放了很多的參數。下一篇我們將接着講Builder階段，給了你那么多，你要開始制造點什么東西給我了。

本文首發於公眾號jessetalk，轉載請保留公眾號二維碼。