這篇文章給大家分享的是有關ASP.NET Core3.X終端中間件如何轉換為端點路由運行的內容。小編覺得挺實用的,因此分享給大家做個參考,一起跟隨小編過來看看吧。
青岡ssl適用于網(wǎng)站、小程序/APP、API接口等需要進行數(shù)據(jù)傳輸應用場景,ssl證書未來市場廣闊!成為創(chuàng)新互聯(lián)建站的ssl證書銷售渠道,可以享受市場價格4-6折優(yōu)惠!如果有意向歡迎電話聯(lián)系或者加微信:18982081108(備注:SSL證書合作)期待與您的合作!路由的進階
路由負責將請求 URI 映射到終結點并向這些終結點調度傳入的請求。 路由在應用中定義,并在應用啟動時進行配置。 路由可以選擇從請求包含的 URL 中提取值,然后這些值便可用于處理請求。 通過使用應用中的路由信息,路由還能生成映射到終結點的 URL。
在ASP.NET Core 2.1和更低版本中,路由是通過實現(xiàn)將IRouter傳入的URL映射到處理程序的接口來處理的。通常,將直接依賴MvcMiddleware添加到中間件管道末端的實現(xiàn),而不是直接實現(xiàn)該接口。一旦請求到達MvcMiddleware,便會應用路由來確定傳入請求URL路徑所對應的控制器和操作。
然后,該請求在執(zhí)行處理程序之前經(jīng)過了各種MVC篩選器。這些過濾器形成了另一條“管道”,讓人聯(lián)想到中間件管道,并且在某些情況下必須復制某些中間件的行為。一個典型的例子就是CORS政策。為了對每個MVC操作以及中間件管道的其他“分支”實施不同的CORS策略,內部需要進行一定程度的重復。
“分支”中間件管道通常用于“偽路由”。如Map()在中間件管道中的擴展方法,將允許您在傳入路徑具有給定前綴時有條件地執(zhí)行某些中間件。
如下所示:
app.Map("/order", app => app.Run(async context => { await context.Response.WriteAsync("Order"); }) );
在這種情況下,該Run()方法是“終端”中間件,因為它返回響應。但是從某種意義上說,整個Map分支對應于應用程序的“端點”.
在ASP.NET Core 2.2中,引入了終結點路由作為MVC控制器的新路由機制。此實現(xiàn)本質上是的內部實現(xiàn)MvcMiddleware .
在ASP.NET Core 2.x中使用Map()
下面我們自定義一個中間件,該中間件返回直接返回一個相應而不是繼續(xù)往下執(zhí)行調用_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()); versionApp.UseMiddleware ()); app.UseMvcWithDefaultRoute(); }
當我們訪問 /order 或者 /order/1 路由都會得到自定義中間件返回的相應。
將中間件轉換為端點路由
在ASP.NET Core 3.0中,我們使用端點路由,因此路由步驟與端點的調用是分開的。實際上,這意味著我們有兩個中間件:
EndpointRoutingMiddleware 實際的路由,即計算將為指定的請求URL路徑調用哪個端點。
EndpointMiddleware 所有調用的端點。
它們在中間件管道中的兩個不同點處添加,因為它們起著兩個不同的作用。一般而言,我們想的是路由中間件提前在管道中,以便后續(xù)的中間件可以訪問有關將執(zhí)行的端點的信息。端點的調用應在管道的末端進行。
如下所示:
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().Build()).WithDisplayName("order-api");
在我們上面針對ASP.NET Core 2.x的實現(xiàn)中,我們將匹配/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().Build()).WithDisplayName("order-api").RequireCors("AllowAllHosts") .RequireAuthorization("AdminOnly"); });
我們向端點添加了CORS策略(AllowAllHosts)和授權策略(AdminOnly)。當?shù)竭_端點的請求到達時,并在執(zhí)行端點之前采取相應的措施。
感謝各位的閱讀!關于“ASP.NET Core3.X終端中間件如何轉換為端點路由運行”這篇文章就分享到這里了,希望以上內容可以對大家有一定的幫助,讓大家可以學到更多知識,如果覺得文章不錯,可以把它分享出去讓更多的人看到吧!