1. 程式人生 > >ASP.NET Core 2.0 : 五.服務是如何加載並運行的, Kestrel、配置與環境

ASP.NET Core 2.0 : 五.服務是如何加載並運行的, Kestrel、配置與環境

log oid 方案 配置 結構 soc windows系統 ogg apps

"跨平臺"後的ASP.Net Core是如何接收並處理請求的呢? 它的運行和處理機制和之前有什麽不同?

本章從"宏觀"到"微觀"地看一下它的結構以及不同時期都幹了些什麽.

ASP.NET Core 系列目錄

本章主要內容如下:

ASP.NET Core 的運行機制: "宏觀"的看一下Http請求的處理流程.

ASP.NET Core 的配置與運行: 2倍放大後的ASP.NET Core Application, Kestrel服務器、啟動與配置

ASP.NET Core 的環境變量.

ASP.NET Core 的運行機制

技術分享圖片

圖1

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 Application是如何運行的呢? 我們將圖1中ASP.NET Core Application這個紅框框放大一下,看下一節.

ASP.NET Core 的啟動

看一下將圖1的ASP.NET Core Application放大後的樣子:

技術分享圖片

圖2

④Main方法, 程序的起點.

⑤創建並配置WebHostBuilder: 首先調用Create­DefaultBuilder( 如圖所示, 它是一系列配置的大綜合,下文做詳細介紹), 進行一系列配置之後, 調用 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的一系列配置

系統離不開各種各樣的配置, 比如常見的讀取配置文件, 指定日誌處理程序等, 我們詳細的看一下.

Create­DefaultBuilder

CreateDefaultBuilder, 顧名思義, 它是一個默認配置 . 如圖2所示, 它主要是調用了各種ConfigureXXX和UseXXX, 首先看一下它的源碼

技術分享圖片
 1 public static IWebHostBuilder CreateDefaultBuilder(string[] args)
 2 {
 3     var builder = new WebHostBuilder()
 4         .UseKestrel()
 5         .UseContentRoot(Directory.GetCurrentDirectory())
 6         .ConfigureAppConfiguration((hostingContext, config) =>
 7         {
 8             var env = hostingContext.HostingEnvironment;
 9 
10             config.AddJsonFile("appsettings.json", optional: true, reloadOnChange: true)
11                   .AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true, reloadOnChange: true);
12 
13             if (env.IsDevelopment())
14             {
15                 var appAssembly = Assembly.Load(new AssemblyName(env.ApplicationName));
16                 if (appAssembly != null)
17                 {
18                     config.AddUserSecrets(appAssembly, optional: true);
19                 }
20             }
21 
22             config.AddEnvironmentVariables();
23 
24             if (args != null)
25             {
26                 config.AddCommandLine(args);
27             }
28         })
29         .ConfigureLogging((hostingContext, logging) =>
30         {
31             logging.AddConfiguration(hostingContext.Configuration.GetSection("Logging"));
32             logging.AddConsole();
33             logging.AddDebug();
34         })
35         .UseIISIntegration()
36         .UseDefaultServiceProvider((context, options) =>
37         {
38             options.ValidateScopes = context.HostingEnvironment.IsDevelopment();
39         });
40 
41     return builder;
42 }
技術分享圖片

上面的源碼中我們看到它這些ConfigureXXX和UseXXX的過程, 而在Core 1.0版本中是沒有CreateDefaultBuilder這個方法的,

系統默認是逐個調用這些ConfigureXXX和UseXXX的,在Core 2.0中, 為了代碼簡潔和使用方便, 將這些常規情況下需要調用的方法放到了這個名為CreateDefaultBuilder的方法中.

一般情況下,調用Create­DefaultBuilder 執行其中的這些的默認配置足夠用了。但既然這是默認配置, 我們就可以根據自身情況自定義.

因為這些配置都是對 WebHostBuilder進行修改, 而修改後再次返回修改後的 WebHostBuilder, 所以在Create­DefaultBuilder不符合現實需求的情況下可以通過如下的方法進行自定義.

1)不調用Create­DefaultBuilder, 將上面講到的這些配置選擇性的執行, 甚至可以添加、替換裏面的某些配置, 如將UseKestrel改為UseHttpSys.

2)小幅改動, 即調用Create­DefaultBuilder之後再對其返回的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, 這裏進行了兩個比較重要的工作, ⑧服務的依賴註入和⑨配置管道,

下文我們將圖2的⑩Startup這個紅框框放大一些, 看看這裏都做了些什麽.

ASP.NET Core 系列目錄

原文地址:https://www.cnblogs.com/FlyLolo/p/ASPNETCore2_5.html

ASP.NET Core 2.0 : 五.服務是如何加載並運行的, Kestrel、配置與環境