我心中的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 transportservices.TryAddSingleton<ITransportFactory, SocketTransportFactory>();services.AddTransient<IConfigureOptions<KestrelServerOptions>, KestrelServerOptionsSetup>();services.AddSingleton<IServer, KestrelServer>();}); }其實也很簡單,都是在進行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>(); ?
?return new ConventionBasedStartup(StartupLoader.LoadMethods(sp, startupType, hostingEnvironment.EnvironmentName));}); }
VS為我們添加的Startup.cs默認不繼續IStartup接口,所以是采用Convention的這種方式,當然我們也可以繼承IStartup則直接注冊成單例到應用程序。
以上是整個 WebHostBuilder的準備階段,即往里面放了很多的參數。下一篇我們將接著講Builder階段,給了你那么多,你要開始制造點什么東西給我了
原文地址:http://www.jessetalk.cn/2017/11/11/aspnet-core-object-webhost/
.NET社區新聞,深度好文,歡迎訪問公眾號文章匯總 http://www.csharpkit.com
總結
以上是生活随笔為你收集整理的我心中的ASP.NET Core 新核心对象WebHost(一)的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Debug ASP.NET Core 2
- 下一篇: Scaffolding Template