歡迎光臨
每天分享高質量文章

ASP.NET Core中HTTP管道和中間件的二三事

本文出自《從零開始學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";

    已同步到看一看
    赞(0)

    分享創造快樂