本文出自《從零開始學ASP.NET CORE MVC》
推薦文章：中介軟體是什麼？在.NET Core中的工作原理又是怎樣的呢？

配置ASP.NET Core請求(Request)處理管道

在本影片中，我們將討論使用中介軟體元件為asp.net core 應用程式配置請求處理管道。

作為應用程式啟動的一部分，我們要在Configure（）方法中設定請求處理管道。

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
    }

    public void Configure(IApplicationBuilder app, IHostingEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }

        app.Run(async (context) =>
        {
            await context.Response.WriteAsync("Hello World!");
        });
    }

}

目前我們的程式碼中有2個中介軟體在管道中 ：UseDeveloperExceptionPage()方法和Run()方法

UseDeveloperExceptionPage 中介軟體：顧名思義，如果存在異常並且環境是Development，此中介軟體會被呼叫，顯示開發異常頁面。 我們將在後面的影片中討論這個DeveloperExceptionPage中介軟體和環境變數的使用。

第二個中介軟體是註冊Run()方法到管道中,它只能處理將一個資訊傳入Response物件。 目前，它是一個響應每個請求的中介軟體，傳回Hello world。
在這種情況下，無論您的請求路徑是什麼。 所有請求都會被這個中介軟體所處理，我們得到的傳回值都是這個中介軟體呼叫Response物件,傳回的string型別的字串。
傳回的值是純文字而不是html。 我們可以透過檢查頁面原始碼來確認這一點。
可以看到，我們在原始碼中沒有任何html標記。 只是純文字。

即使您現在建立一個為52abp.html的檔案，並且您在請求中包含該檔案的路徑，我們的應用程式也無法傳回該靜態檔案。 這是因為，目前我們的請求處理管道沒有可以提供靜態檔案的中介軟體，如html檔案，影象，CSS和JavaScript檔案。
在後面的課程中，我們將新增所需的中介軟體以便能夠提供靜態檔案。

研究下 Configure（）方法中的程式碼。

app.Run(async (context) =>
{
    await context.Response.WriteAsync("Hello World!");
});

程式碼說明:

• 我們呼叫Run() 方法新增中介軟體到請求處理管道中。
• 如果將滑鼠懸停在Run（）方法上，則可以從 智慧提示中看到Run（）方法是作為IApplicationBuilder介面的擴充套件方法實現的。這就是我們能夠在IApplicationBuilder物件應用程式上呼叫此Run（）方法的原因。
• 我們傳遞給Run（）方法的引數是一個RequestDelegate，我們可以從智慧提示中看到它。
• RequestDelegate是一個作為HttpContext物件的引數委託。
• 透過這個HttpContext物件，中介軟體可以訪問傳入的http請求和傳出的http響應。
• 目前，我們使用lambda將請求，它透過委託行內的方式作為匿名方法傳遞,所以很多人都說lambda運算式是一種特殊的委託。如果你聽不明白lambda運算式，委託，及行內，你可以參考學習:
  • 委託（delegate）
  • Lambda簡介 ,或者等我錄製C#的基礎影片吧。
• 使用Run()擴充套件方法，我們只能將一個終端中介軟體新增到請求管道。
• 終端中介軟體是我們之前已經說到過，他會使管道短路，不會去呼叫下一個中介軟體。

研究下麵的程式碼

app.Run(async (context) =>
{
    await context.Response.WriteAsync("從第一個中介軟體中列印Hello World");
});

app.Run(async (context) =>
{
    await context.Response.WriteAsync("從第二個中介軟體中列印Hello World");
});

• 我們使用Run（）方法註冊了2個中介軟體。
• 執行此專案時，我們只看到第一個中介軟體的響應，有傳回值。
• 我們沒有看到第二個中介軟體的響應。
• 這是因為，使用Run（）方法註冊的中介軟體無法呼叫管道中的下一個中介軟體。
• 因此，我們使用Run（）方法註冊的中介軟體是終端中介軟體

如果您希望中介軟體能夠呼叫管道中的下一個中介軟體，則使用Use（）方法註冊中介軟體，如下所示。

app.Use(async (context, next) =>
{
    await context.Response.WriteAsync("從第一個中介軟體中列印Hello World");
    await next();
});

app.Run(async (context) =>
{
    await context.Response.WriteAsync("從第二個中介軟體中列印Hello World");
});

註意，Use（）方法有2個引數。第一個引數是HttpContext背景關係物件，第二個引數是Func型別，即它是代表管道中下一個中介軟體的通用委託。

我們再看看以下程式碼

public void Configure(IApplicationBuilder app, IHostingEnvironment env,
                ILogger logger)
{
    app.Use(async (context, next) =>
    {
        logger.LogInformation("MW1:傳入請求");
        await next();
        logger.LogInformation("MW1:傳出響應");
    });

    app.Use(async (context, next) =>
    {
        logger.LogInformation("MW2: 傳入請求");
        await next();
        logger.LogInformation("MW2: 傳出響應");
    });

    app.Run(async (context) =>
    {
        await context.Response.WriteAsync("MW3: 處理請求並生成響應");
        logger.LogInformation("MW3: 處理請求並生成響應");
    });
}

• ILogger < Startup >被註入到Configure（）方法中
• Main（）方法呼叫的CreateDefaultBuilder（）配置日誌記錄
• 您可以透過檢視在GitHub的原始碼驗證這一點
  ：https：//github.com/aspnet/MetaPackages/blob/release/2.2/src/Microsoft.AspNetCore/WebHost.cs
• 檢查方法ConfigureLogging（）,* 您會發現，ILogger配置了Console，Debug和EventSource三種.
• 我們使用依賴註入的方式將ILogger記錄到系統中。
• 如果使用.NET Core CLI執行專案，則可以在“控制檯”視窗中檢視記錄的資訊
• 如果直接從Visual Studio執行專案，則可以在輸出視窗中檢視記錄的資訊。從輸出視窗的下拉串列中選擇ASP.NET Core Web Server。
• 您將看到，資訊按以下順序記錄
  • MW1：傳入請求
  • MW2：傳入請求
  • MW3：處理請求並生成響應
  • MW2：傳出響應
  • MW1：傳出響應

現在將上面的輸出與微軟的官方檔案中的下圖集合起來，是不是就清晰明瞭啊。吐槽下，微軟的檔案有粗糙。

image.png

• 請記住，asp.net Core中的中介軟體可以訪問傳入請求和傳出響應

• 請求先到達Middleware1，它記錄（MW1：傳入請求），因此我們首先看到此訊息。

• 然後Middleware1呼叫next（）。next（）會呼叫管道中的Middleware2。

• Middleware2 記錄（MW2：傳入請求）。

• 然後 Middleware2 會呼叫next()再呼叫 Middleware3.

• Middleware3處理請求並生成響應。因此，我們看到的下一條訊息是（MW3：處理請求並生成響應)

• 此時管道開始逆轉。

• 此時控制權將，交回到Middleware2，並將Middleware3生成的響應傳遞給它。Middleware2記錄（MW2：傳出響應），這是我們接下來看到的。

• 最後, Middleware2將控制權交給 Midleware1。

• Middleware1 記錄 (MW1: 傳出響應), 這是我們最後看到的。

請求處理管道的中3個非常重要的知識點：

• 所有的請求都會在每個中介軟體元件呼叫next（）方法之前觸發。請求按照圖中箭頭的所示方向，依次穿過所有管道。
• 當中介軟體處理請求並產生響應時，請求處理流程在管道中開始反向傳遞。
• 所有的響應都會在每個中介軟體元件呼叫next（）方法之前觸發。響應按照圖中箭頭的所示方向，依次穿過所有管道。

小結

亂碼問題

                context.Response.ContentType = "text/plain; charset=utf-8";