服務是如何載入並執行的, Kestrel、配置與環境
ASP.NET Core 的執行機制
ASP.NET Core 的執行機制如上圖所示, 現在做一下詳細說明.
①Web Server: ASP.NET Core提供兩種伺服器可用, 分別是Kestrel和HTTP.sys(Core 1.x 中被命名為 WebListener),
A. Kestrel是一個跨平臺的Web伺服器;
B. HTTP.sys只能用在Windows系統中.
②Internet: 當需要部署在Internal Network 中並需要 Kestrel 中沒有的功能(如 Windows 身份驗證)時,可以選擇HTTP.sys。
③IIS、Apache、Nginx: Kestrel 可以單獨使用 ,也可以將其與反向代理伺服器(如 IIS、Nginx 或 Apache)結合使用。 請求經這些伺服器進行初步處理後轉發給Kestrel(即圖中虛線的可選流程).
ASP.NET Core 的啟動
④Main方法, 程式的起點.
⑤建立並配置WebHostBuilder: 首先呼叫CreateDefaultBuilder( 如圖所示, 它是一系列配置的大綜合,下文做詳細介紹), 進行一系列配置之後, 呼叫 UseStartup<T>(),
指定⑩Startup為啟動配置檔案. 在Startup中, 將進行兩個比較重要的工作, ⑧服務的依賴注入和⑨配置管道, 後文將對這一部分詳細的介紹.
⑥生成WebHostBuilder並進行了一系列配置之後, 通過這個WebHostBuilder來Build出一個IWebHost.
⑦呼叫IWebHost的Run方法使之開始執行.
ASP.NET Core 應用程式本質上是控制檯應用程式,所以它也是以一個我們熟悉的Main方法作為程式的起點.
開啟Program.cs檔案, 預設是如下程式碼
public class Program { public static void Main(string[] args) { BuildWebHost(args).Run(); } public static IWebHost BuildWebHost(string[] args) => WebHost.CreateDefaultBuilder(args) .UseStartup<Startup>() .Build(); }
定義了一個BuildWebHost方法, 在Main中呼叫它返回一個IWebHost, 並使這個IWebHost"Run起來". 再看BuildWebHost方法內部, 通過呼叫CreateDefaultBuilder
建立了一個IWebHostBuilder, 然後用這個Builder來Build出一個IWebHost.
簡單來說就是 建立IWebHostBuilder=>Builder=>Build()=>IWebHost=>Run().
WebHostBuilder的一系列配置
系統離不開各種各樣的配置, 比如常見的讀取配置檔案, 指定日誌處理程式等, 我們詳細的看一下.
CreateDefaultBuilder
CreateDefaultBuilder, 顧名思義, 它是一個預設配置 . 如圖2所示, 它主要是呼叫了各種ConfigureXXX和UseXXX, 首先看一下它的原始碼
public static IWebHostBuilder CreateDefaultBuilder(string[] args) { var builder = new WebHostBuilder() .UseKestrel() .UseContentRoot(Directory.GetCurrentDirectory()) .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()) { var appAssembly = Assembly.Load(new AssemblyName(env.ApplicationName)); if (appAssembly != null) { config.AddUserSecrets(appAssembly, optional: true); } } config.AddEnvironmentVariables(); if (args != null) { config.AddCommandLine(args); } }) .ConfigureLogging((hostingContext, logging) => { logging.AddConfiguration(hostingContext.Configuration.GetSection("Logging")); logging.AddConsole(); logging.AddDebug(); }) .UseIISIntegration() .UseDefaultServiceProvider((context, options) => { options.ValidateScopes = context.HostingEnvironment.IsDevelopment(); }); return builder; }
上面的原始碼中我們看到它這些ConfigureXXX和UseXXX的過程, 而在Core 1.0版本中是沒有CreateDefaultBuilder這個方法的,
系統預設是逐個呼叫這些ConfigureXXX和UseXXX的,在Core 2.0中, 為了程式碼簡潔和使用方便, 將這些常規情況下需要呼叫的方法放到了這個名為CreateDefaultBuilder的方法中.
一般情況下,呼叫CreateDefaultBuilder 執行其中的這些的預設配置足夠用了。但既然這是預設配置, 我們就可以根據自身情況自定義.
因為這些配置都是對 WebHostBuilder進行修改, 而修改後再次返回修改後的 WebHostBuilder, 所以在CreateDefaultBuilder不符合現實需求的情況下可以通過如下的方法進行自定義.
1)不呼叫CreateDefaultBuilder, 將上面講到的這些配置選擇性的執行, 甚至可以新增、替換裡面的某些配置, 如將UseKestrel改為UseHttpSys.
2)小幅改動, 即呼叫CreateDefaultBuilder之後再對其返回的WebHostBuilder呼叫自定義的其他配置方法. 例如可以再次呼叫 ConfigureAppConfiguration,從而新增更多的配置源.
下面來介紹一下這些ConfigureXXX和UseXXX.
A. UseKestrel
用於指定伺服器使用 Kestrel, 若使用HttpSys, 需使用UseHttpSys。
Kestrel 是跨平臺 ASP.NET Core Web 伺服器,它基於 libuv(一個跨平臺非同步 I/O 庫)。 Kestrel 是 Web 伺服器,預設包括在 ASP.NET Core 專案模板中。
Kestrel 支援以下功能:
HTTPS
用於啟用 WebSocket 的不透明升級
用於獲得 Nginx 高效能的 Unix 套接字.
預設情況下,ASP.NET Core 專案模板使用的是 Kestrel。
我們可以再次呼叫UseKestrel來修改Kestrel的配置, 例如限制請求正文的最大值
public static IWebHost BuildWebHost(string[] args) =>
WebHost.CreateDefaultBuilder(args)
.UseStartup<Startup>()
.UseKestrel(options =>
{
options.Limits.MaxRequestBodySize = 10 * 1024;
})
.Build();
B. UseContentRoot
為應用程式指定根目錄。需注意這和 StaticFiles的根是不同的, 雖然預設情況下StaticFiles的根是以ContentRoot為依據 ([ContentRoot]/wwwroot)。
C. ConfigureAppConfiguration
讀取配置。如上程式碼會讀取 appsettings.json 和 appsettings.{env.EnvironmentName}.json , env.EnvironmentName指的是環境, 例如Development. 當在Development環境的時候, 還會讀取使用者金鑰。
這部分在學習系統配置的時候詳細介紹.
D. ConfigureLogging
配置日誌處理程式,控制檯和除錯日誌提供程式, 學習日誌的時候再詳講.
E. UseIISIntegration
將應用程式配置為在 IIS 中執行。上面已經講過, 這裡仍需要使用 UseKestrel, 而IIS 起到反向代理的作用,而 Kestrel 仍用作主機。
如果應用程式沒有使用 IIS 作為反向代理,那麼 UseIISIntegration 不會有任何效果。因此,即使應用程式在非 IIS 方案中執行,也可以安全呼叫這種方法。
F.UseDefaultServiceProvider
設定預設的依賴注入容器, 這部分在後面學習依賴注入的時候再詳講.
ASP.NET Core 的環境
在 ASP.NET Core 中,有個非常重要而且常用的東西叫環境變數, 它由 ASPNETCORE_ENVIRONMENT 環境變數指定。
我們可以根據需要將此變數設定為任意值,但通常使用的是值 Development、Staging 和 Production。它定義了當前應用程式的執行環境, 我們經常會根據這個變數來讓應用採用不同的處理方式.
在上面的例子中, 就有這樣的用法
if (env.IsDevelopment())
{
var appAssembly = Assembly.Load(new AssemblyName(env.ApplicationName));
if (appAssembly != null)
{
config.AddUserSecrets(appAssembly, optional: true);
}
}
_Layout View 中
<environment include="Development">
<link rel="stylesheet" href="~/lib/bootstrap/dist/css/bootstrap.css" />
<link rel="stylesheet" href="~/css/site.css" />
</environment>
因此,如果在run 之前將 ASPNETCORE_ENVIRONMENT 變數設定為 Development(或在 launchSettings.json 檔案中設定此環境變數),
應用程式會在 Development 模式下執行,而不是 Production 模式(這是不設定任何變數時的預設模式)。
注意:在 Windows 和 macOS 上,環境變數和值不區分大小寫。Linux 環境變數和值區分大小寫。
小結
通過上面的內容大概對ASP.NET Core 2.0 的服務啟動、配置與執行, 執行環境等做了大概的瞭解, 其中涉及的部分內容如讀取配置、日誌等, 將在後期單獨介紹.
除了上述內容, ASP.NET Core留給我們作為擴充套件的地方主要放在了Startup檔案中, 即圖2中的⑩Startup, 這裡進行了兩個比較重要的工作, ⑧服務的依賴注入和⑨配置管道,
原文連結:https://blog.csdn.net/Lolo_cs_dn/article/details/79631674