小白開學Asp.Net Core 《七》

阿新 • • 發佈：2019-07-13

小白開學Asp.Net Core 《七》

　　　　　　— — 探究中介軟體（MiddleWare）

1、何為中介軟體？

　　中介軟體是組裝到應用程式管道中以處理請求和響應的傢伙，管道中的每個元件都要滿足以下兩個條件

選擇是否將請求傳遞給管道中的下一個元件
可以在呼叫管道中的下一個元件之前和之後執行工作。

2、中介軟體的本質

　在.Net Core 中，中介軟體的本質就是一個Func的委託，其中RequestDelegate的本質也是一個委託（常常聽人說，要想進階到高階開發，必須要搞清楚委託。看來不得不搞懂委託了，本文預設您已搞懂了？如果沒搞懂怎麼辦呢？不要緊，抽時間搞懂就行了），讓我們來看看它的定義（證明我沒在吹牛）

再來看看 RequestDelegate

接下來我嘗試著解釋下Func這個委託。我們都知道 Func 這個內建的委託

（我只截了與本文相關的一張圖）

　通過Func 這個截圖的定義來看，它接受一個 T 返回一個 TResult ，結合我們前面說的中介軟體來說，它接受一個RequestDelegate，返回一個RequestDelegate。也就是說，每一箇中間件Func的傳入引數RequestDelegate是下一個中介軟體的返回值，同時每一箇中間件Func的返回值是前一箇中間件的傳入引數。這樣就構成了一串中介軟體連結串列，每當一個請求過來，都會按照中介軟體的註冊順序依次執行RequestDelegate中的內容，這就構成了ASP.NET Core中的請求管道。（好好理解這句話，這是真理呀，開個玩笑，這是我本人這麼認為的。）

這裡得上一張經典的圖配合上一句真理來理解就不那麼難了。

　　好，我們現在知道了Http請求處理管理是由多個Middleware組成的。可我們上面從沒提到Http相關的資訊，現在讓我們看看它們是如何發生戀愛（產生關係的）？

　　仔細看了前文的話，大家應該注意到RequestDelegate的定義（仔細回想下），哎估計你們都想起來了，對還是上圖我們再學習下

這次我把這個傢伙的定義到截到圖裡，我們嘗試著翻譯下：A function that can process an HTTP request. 我將它翻譯為：一個能夠處理HTTP請求的 function（函式、方法）。是不是大家突然間知道了，原來是這個傢伙讓它們與HTTP關聯在一起的（產生了戀情）。

好，如果你不信的話就讓我們來看看 HttpContext 這個傢伙。為什麼要看這個傢伙呢，因為它是 RequestDelegate 這個委託接受的引數。

好了，這裡不得不相信，.Net Core 的 Http 請求處理管道是由多個Middleware 組成的，並且 Middleware 與 Http 請求上下文僅僅的關聯在一起。

　　使用Use、Run和Map 配置HTTP管道。

3、Use、Run和Map

　　您可以使用Use、Run和Map 來配置HTTP管道，但各方法針對構建的中介軟體作用不同.

　　Use：Use[Middleware]中介軟體負責呼叫管道中的下一個中介軟體，也可使管道短路（即不呼叫 next 請求委託)。

　　Run：Run[Middleware]是一種約定，一些中介軟體元件可能會公開在管道末端執行的Run[Middleware]方法。

　　Map： Map擴充套件用作約定來建立管道分支, Map*建立請求管道分支是基於給定請求路徑的匹配項。

public class Startup
{
    public void Configure(IApplicationBuilder app)
    {
        app.Use(async (context, next) =>
        {
            // Do work that doesn't write to the Response.
            await next.Invoke();
            // Do logging or other work that doesn't write to the Response.
        });

        app.Run(async context =>
        {
            await context.Response.WriteAsync("Hello from 2nd delegate.");
        });
    }
}

Use將多個請求委託連結在一起，next 引數表示管道中的下一個委託，可通過不呼叫 next 引數使管道短路。通常可在下一個委託前後執行操作。

當委託不將請求傳遞給下一個委託時，它被稱為“讓請求管道短路” 。通常需要短路，因為這樣可以避免不必要的工作。

Run委託終止管道。意思就是說，使用的Run 委託後，Run 下面的所有方法將不會被執行。

public class Startup
{
    private static void HandleMap1(IApplicationBuilder app)
    {
        app.Run(async context =>
        {
            await context.Response.WriteAsync("Map  1");
        });
    }

    private static void HandleMap2(IApplicationBuilder app)
    {
        app.Run(async context =>
        {
            await context.Response.WriteAsync("Map  2");
        });
    }

    public void Configure(IApplicationBuilder app)
    {
        app.Map("/map1", HandleMap1);

        app.Map("/map2", HandleMap2);

        app.Run(async context =>
        {
            await context.Response.WriteAsync("Hello from End Map delegate.");
        });
    }
}

執行與響應如下：

請求	響應
localhost:5000	Hello from End Map delegate.
localhost:5000/map1	Map 1
localhost:5000/map2	Map 2

4、總結

　　1）、中介軟體（Middleware）是由IApplicationBuilder來構建的

　　2）、所有的程式碼截圖都是 IApplicationBuilder F12後看到的

5、說明

　　參考文章：https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/middleware/?view=aspnetcore-3.0

　　如果本文有描述不對的地方或者產生誤導的地方，請及時反饋。

小白開學Asp.Net Core 《七》