.NET Core中間件的注冊和管道的構(gòu)建（3） ---- 使用Map/MapWhen擴展方法

0x00 為什么需要Map（MapWhen）擴展

如果業(yè)務邏輯比較簡單的話，一條主管道就夠了，確實用不到Map。不過當業(yè)務邏輯比較復雜的時候，有時候我們可能希望根據(jù)情況的不同使用特殊的一組中間件來處理HttpContext。這種情況下如果只用一條管道，處理起來會非常麻煩和混亂。此時就可以使用Map/MapWhen建立一個分支管道，當條件符合我們的設定時，由這個分支管道來處理HttpContext。使用Map/MapWhen添加分支管道是很容易的，只要提供合適跳轉(zhuǎn)到分支管道的判斷邏輯，以及分支管道的構(gòu)建方法就可以了。

0x01 Map擴展的原理

前一篇文章中我們說過，中間件的注冊和管道的構(gòu)建都是通過ApplicationBuilder進行的。因此要構(gòu)建一個分支管道，需要一個新的ApplicationBuilder，并用它來注冊中間件，構(gòu)建管道。為了在分支管道中也能夠共享我們在當前ApplicationBuilder中注冊的服務（或是說共享依賴注入容器，當然共享的并不止這些），在創(chuàng)建新的ApplicationBuilder時并不是直接new一個全新的，而是調(diào)用當前ApplicationBuilder的New方法在當前的基礎上創(chuàng)建新的，共享了當前ApplicationBuilder的Properties（其中包含了依賴注入容器）。

在使用Map注冊中間件時我們會傳入一個Action<IApplicationBuilder>參數(shù)，它的作用就是，當我們創(chuàng)建了新的ApplicationBuilder后，使用這個方法對其進行各種設置，最重要的就是在新的ApplicationBuilder上注冊分支管道的中間件。配置完成后調(diào)用分支ApplicationBuilder的Builder方法構(gòu)建管道，并把第一個中間件保存下來作為分支管道的入口。

在使用Map注冊中間件時傳入了一個PathString參數(shù)，PathString對象我們可以簡單地認為是string。它用于記錄HttpContext.HttpRequest.Path中要匹配的區(qū)段（Segment）。這個字符串參數(shù)結(jié)尾不能是“/”。如果匹配成功則進入分支管道，匹配失則敗繼續(xù)當前管道。

新構(gòu)建的管道和用于匹配的字符串保存為MapOptions對象，保存了Map規(guī)則和分支管道的入口。之后構(gòu)建MapMiddleware對象，并把它的Invoke方法包裝為RequestDelegate，使用當前ApplicationBuilder的Use方法注冊中間件。

下面是Map擴展方法：

下面是MapMiddleware的Invoke方法

0x02 MapWhen擴展的原理

Map主要通過URL中的Path來判斷是否需要進入分支管道，但有時候我們很可能會有別的需求，例如我想對所有Method為DELETE的請求用特殊管道處理。這時候就需要用MapWhen了。MapWhen是一種通用的Map，可以由使用者來決定什么時候進入分支管道什么時候不進入。可以說Map是MapWhen的一種情況，因為這種情況太常見了，所以官方實現(xiàn)了一個。這樣看來MapWhen就很簡單了，在Map中我們傳入?yún)?shù)PathString來進行HttpRequest.Path的匹配，在MapWhen中我們傳入Func<HttpContext,bool>參數(shù)，有我們自行指定，當返回true時進入分支管道，返回false則繼續(xù)當前管道。

下面是MapWhen擴展方法：

下面是MapWhenMiddleware的Invoke方法：

0x03 順便提一下Run擴展

還有一個注冊中間件的擴展方法是Run，因為非常簡單，所以在最后提一下。Run就是用Use注冊一個中間件，最后不調(diào)用下一個中間件直接返回。所以使用Run擴展方法注冊中間件永遠都是直接返回的，后面的中間件都不會被調(diào)用。

0x04 寫在最后

Map/MapWhen和Run都很簡單就不寫測試了。到此為止中間件的注冊和管道的構(gòu)建主題就寫完了。剛開始是出于對中間件有些地方的迷惑開始的，搞明白了后本想著寫一篇博客分享下自己的心得，沒想到越寫越多，一篇分成兩篇，到現(xiàn)在寫了三篇。我這些也只是寫了些大概，很多細節(jié)沒寫到，有興趣的可以去github上看一下代碼，管道和中間件相關的都在這個倉庫：https://github.com/aspnet/HttpAbstractions。

0x05 相關文章

.NET Core中間件的注冊和管道的構(gòu)建（1）---- 注冊和構(gòu)建原理

.NET Core中間件的注冊和管道的構(gòu)建（2）---- 用UseMiddleware擴展方法注冊中間件類

.NET Core中間件的注冊和管道的構(gòu)建（3） ---- 使用Map/MapWhen擴展方法

更多內(nèi)容歡迎訪問我的博客：http://www.durow.vip