ASP.NET Core3.X 終端中間件轉換為端點路由運行

来源:https://www.cnblogs.com/yyfh/archive/2019/12/09/12010232.html

引言 前幾天 ".NET Core3.1發佈" ,於是我把公司一個基礎通用系統升級了,同時刪除了幾個基礎模塊當然這幾個基礎模塊與.NET Core3.1無關,其中包括了支付模塊,升級完後靜文(同事)問我你把支付刪除了啊?我說是啊,沒考慮好怎麼加上(感覺目前不太好,我需要重新設計一下)。 故事從這開始 ...


引言

前幾天.NET Core3.1發佈,於是我把公司一個基礎通用系統升級了,同時刪除了幾個基礎模塊當然這幾個基礎模塊與.NET Core3.1無關,其中包括了支付模塊,升級完後靜文(同事)問我你把支付刪除了啊?我說是啊,沒考慮好怎麼加上(感覺目前不太好,我需要重新設計一下)。

故事從這開始

考慮支付的時候我考慮的是將支付sdk如何直接引入到系統,以及可以有一系列支付的路由,我需要考慮的是如果創建響應給指定的地址,so我開始想如何達到我的目的自定義個中間件,Use、Run、Map???

路由的進階

路由負責將請求 URI 映射到終結點並向這些終結點調度傳入的請求。 路由在應用中定義,併在應用啟動時進行配置。 路由可以選擇從請求包含的 URL 中提取值,然後這些值便可用於處理請求。 通過使用應用中的路由信息,路由還能生成映射到終結點的 URL。

在ASP.NET Core 2.1和更低版本中,路由是通過實現將IRouter傳入的URL映射到處理程式的介面來處理的。通常,將直接依賴MvcMiddleware添加到中間件管道末端的實現,而不是直接實現該介面。一旦請求到達MvcMiddleware,便會應用路由來確定傳入請求URL路徑所對應的控制器和操作。

然後,該請求在執行處理程式之前經過了各種MVC篩選器。這些過濾器形成了另一條“管道”,讓人聯想到中間件管道,並且在某些情況下必須複製某些中間件的行為。一個典型的例子就是CORS政策。為了對每個MVC操作以及中間件管道的其他“分支”實施不同的CORS策略,內部需要進行一定程度的重覆。

“分支”中間件管道通常用於“偽路由”。如Map()在中間件管道中的擴展方法,將允許您在傳入路徑具有給定首碼時有條件地執行某些中間件。

如下所示:

       app.Map("/order", app => app.Run(async context =>
              {
                  await context.Response.WriteAsync("Order");
              })
            );

在這種情況下,該Run()方法是“終端”中間件,因為它返迴響應。但是從某種意義上說,整個Map分支對應於應用程式的“端點”.

在ASP.NET Core 2.2中,引入了終結點路由作為MVC控制器的新路由機制。此實現本質上是的內部實現MvcMiddleware .

在ASP.NET Core 2.x中使用Map()

下麵我們自定義一個中間件,該中間件返回直接返回一個相應而不是繼續往下執行調用_next委托,一個很基本的中間件。

    public class ApiEndpointMiddleware
    {
        private readonly RequestDelegate _next;

        public ApiEndpointMiddleware(RequestDelegate next)
        {
            _next = next;
        }

        public async Task InvokeAsync(HttpContext context)
        {
         
            context.Response.StatusCode = 200;

            await context.Response.WriteAsync("Order");
        }

    }

在ASP.NET Core 2.x中,可以通過使用擴展方法指定路由訪問該中間件,從而將其包含在Startup.cs的中間件管道中

public void Configure(IApplicationBuilder app)
{
    app.UseStaticFiles();

    app.Map("/order", app => app.UseMiddleware<ApiEndpointMiddleware>()); versionApp.UseMiddleware<VersionMiddleware>()); 

    app.UseMvcWithDefaultRoute();
}

當我們訪問 /order 或者 /order/1 路由都會得到自定義中間件返回的相應。

將中間件轉換為端點路由

在ASP.NET Core 3.0中,我們使用端點路由,因此路由步驟與端點的調用是分開的。實際上,這意味著我們有兩個中間件:

  • EndpointRoutingMiddleware 實際的路由,即計算將為指定的請求URL路徑調用哪個端點。
  • EndpointMiddleware 所有調用的端點。

它們在中間件管道中的兩個不同點處添加,因為它們起著兩個不同的作用。一般而言,我們想的是路由中間件提前在管道中,以便後續的中間件可以訪問有關將執行的端點的信息。端點的調用應在管道的末端進行。

如下所示:

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

            app.UseHttpsRedirection();

            app.UseRouting();

            app.UseAuthorization();

            app.UseEndpoints(endpoints =>
            {
                endpoints.MapControllers();
            });

        }
        

該UseRouting()擴展方法添加EndpointRoutingMiddleware到管道,同時將UseEndpoints()擴展方法添加EndpointMiddleware到管道。UseEndpoints()實際上為應用程式註冊所有端點的位置。

那麼如何將我們自定義中間件使用端點路由來映射呢?

從概念上講,我們UseEndpoints()使用/OrderURL作為匹配的路徑,將“order”端點的註冊移動到調用中:

         endpoints.MapControllers();
                endpoints.Map("/order",endpoints.CreateApplicationBuilder()
                .UseMiddleware<ApiEndpointMiddleware>().Build()).WithDisplayName("order-api");

在我們上面針對ASP.NET Core 2.x的實現中,我們將匹配/order,/order/123等端點路由

例如:

endpoints.Map("/order/{action}",null);

這將同時匹配 /order /order/1,但不匹配/order/status/1。它比以前的版本功能強大得多.

在上一個示例中,我們提供了一個顯示名稱(主要用於調試目的),但是我們可以附加其他的信息,例如授權策略或CORS策略,其他中間件可以查詢這些信息。例如:

     app.UseEndpoints(endpoints =>
            {
                endpoints.MapControllers();
                endpoints.Map("/order/{action}",endpoints.CreateApplicationBuilder()
                .UseMiddleware<ApiEndpointMiddleware>().Build()).WithDisplayName("order-api").RequireCors("AllowAllHosts")
            .RequireAuthorization("AdminOnly"); 
            });

我們向端點添加了CORS策略(AllowAllHosts)和授權策略(AdminOnly)。當到達端點的請求到達時,併在執行端點之前採取相應的措施。

參考

https://docs.microsoft.com/en-us/aspnet/core/fundamentals/routing?view=aspnetcore-3.1#endpoint-routing-differences-from-earlier-versions-of-routing


您的分享是我們最大的動力!

更多相關文章
一周排行
  • 比如要拆分“呵呵呵90909086676喝喝999”,下麵當type=0返回的是中文字元串“呵呵呵,喝喝”,type=1返回的是數字字元串“90909086676,999”, private string GetStrings(string str,int type=0) { IList<strin ...
  • Swagger一個優秀的Api介面文檔生成工具。Swagger可以可以動態生成Api介面文檔,有效的降低前後端人員關於Api介面的溝通成本,促進項目高效開發。 1、使用NuGet安裝最新的包:Swashbuckle.AspNetCore。 2、編輯項目文件(NetCoreTemplate.Web.c ...
  • 2020 年 7 月 30 日, 由.NET基金會和微軟 將舉辦一個線上和為期一天的活動,包括 微軟 .NET 團隊的演講者以及社區的演講者。本次線上大會 專註.NET框架構建微服務,演講者分享構建和部署雲原生應用程式的最佳實踐、模式、提示和技巧。有關更多信息和隨時瞭解情況:https://focu... ...
  • #abp框架Excel導出——基於vue #1.技術棧 ##1.1 前端採用vue,官方提供 UI套件用的是iview ##1.2 後臺是abp——aspnetboilerplate 即abp v1,https://github.com/aspnetboilerplate/aspnetboilerp ...
  • 前言 本文的文字及圖片來源於網路,僅供學習、交流使用,不具有任何商業用途,版權歸原作者所有,如有問題請及時聯繫我們以作處理。 作者:碧茂大數據 PS:如有需要Python學習資料的小伙伴可以加下方的群去找免費管理員領取 input()輸入 Python提供了 input() 內置函數從標準輸入讀入一 ...
  • 從12年到20年,python以肉眼可見的趨勢超過了java,成為了當今It界人人皆知的編程語言。 python為什麼這麼火? 網路編程語言搜索指數 適合初學者 Python具有語法簡單、語句清晰的特點,這就讓初學者在學習階段可以把精力集中在編程對象和思維方法上。 大佬都在用 Google,YouT ...
  • 在社會上存在一種普遍的對培訓機構的學生一種歧視的現象,具體表現在,比如:當你去公司面試的時候,一旦你說了你是培訓機構出來的,那麼基本上你就涼了,那麼你瞞著不說,然後又通過了面試成功入職,但是以後一旦在公司被髮現有培訓經歷,可能會面臨被降薪,甚至被辭退,培訓機構出來的學生,在用人單位眼裡就是能力低下的 ...
  • from typing import List# 這道題看了大佬寫的代碼,經過自己的理解寫出來了。# 從最外圍的四周找有沒有為O的,如果有的話就進入深搜函數,然後深搜遍歷# 判斷上下左右的位置是否為Oclass Solution: def solve(self, board: List[List[s ...
  • import requests; import re; import os; # 1.請求網頁 header = { "user-agent":'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, li ...
  • import requests; import re; import os; import parsel; 1.請求網頁 header = { "user-agent":'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537. ...