這篇文章給大家分享的是有關(guān)ASP.NET Core3.X終端中間件如何轉(zhuǎn)換為端點(diǎn)路由運(yùn)行的內(nèi)容。小編覺得挺實(shí)用的,因此分享給大家做個(gè)參考,一起跟隨小編過來看看吧。
路由的進(jìn)階
路由負(fù)責(zé)將請(qǐng)求 URI 映射到終結(jié)點(diǎn)并向這些終結(jié)點(diǎn)調(diào)度傳入的請(qǐng)求。 路由在應(yīng)用中定義,并在應(yīng)用啟動(dòng)時(shí)進(jìn)行配置。 路由可以選擇從請(qǐng)求包含的 URL 中提取值,然后這些值便可用于處理請(qǐng)求。 通過使用應(yīng)用中的路由信息,路由還能生成映射到終結(jié)點(diǎn)的 URL。
在ASP.NET Core 2.1和更低版本中,路由是通過實(shí)現(xiàn)將IRouter傳入的URL映射到處理程序的接口來處理的。通常,將直接依賴MvcMiddleware添加到中間件管道末端的實(shí)現(xiàn),而不是直接實(shí)現(xiàn)該接口。一旦請(qǐng)求到達(dá)MvcMiddleware,便會(huì)應(yīng)用路由來確定傳入請(qǐng)求URL路徑所對(duì)應(yīng)的控制器和操作。
然后,該請(qǐng)求在執(zhí)行處理程序之前經(jīng)過了各種MVC篩選器。這些過濾器形成了另一條“管道”,讓人聯(lián)想到中間件管道,并且在某些情況下必須復(fù)制某些中間件的行為。一個(gè)典型的例子就是CORS政策。為了對(duì)每個(gè)MVC操作以及中間件管道的其他“分支”實(shí)施不同的CORS策略,內(nèi)部需要進(jìn)行一定程度的重復(fù)。
“分支”中間件管道通常用于“偽路由”。如Map()在中間件管道中的擴(kuò)展方法,將允許您在傳入路徑具有給定前綴時(shí)有條件地執(zhí)行某些中間件。
如下所示:
app.Map("/order", app => app.Run(async context => { await context.Response.WriteAsync("Order"); }) );
在這種情況下,該Run()方法是“終端”中間件,因?yàn)樗祷仨憫?yīng)。但是從某種意義上說,整個(gè)Map分支對(duì)應(yīng)于應(yīng)用程序的“端點(diǎn)”.
在ASP.NET Core 2.2中,引入了終結(jié)點(diǎn)路由作為MVC控制器的新路由機(jī)制。此實(shí)現(xiàn)本質(zhì)上是的內(nèi)部實(shí)現(xiàn)MvcMiddleware .
在ASP.NET Core 2.x中使用Map()
下面我們自定義一個(gè)中間件,該中間件返回直接返回一個(gè)相應(yīng)而不是繼續(xù)往下執(zhí)行調(diào)用_next委托,一個(gè)很基本的中間件。
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中,可以通過使用擴(kuò)展方法指定路由訪問該中間件,從而將其包含在Startup.cs的中間件管道中
public void Configure(IApplicationBuilder app) { app.UseStaticFiles(); app.Map("/order", app => app.UseMiddleware<ApiEndpointMiddleware>()); versionApp.UseMiddleware<VersionMiddleware>()); app.UseMvcWithDefaultRoute(); }
當(dāng)我們?cè)L問 /order 或者 /order/1 路由都會(huì)得到自定義中間件返回的相應(yīng)。
將中間件轉(zhuǎn)換為端點(diǎn)路由
在ASP.NET Core 3.0中,我們使用端點(diǎn)路由,因此路由步驟與端點(diǎn)的調(diào)用是分開的。實(shí)際上,這意味著我們有兩個(gè)中間件:
EndpointRoutingMiddleware 實(shí)際的路由,即計(jì)算將為指定的請(qǐng)求URL路徑調(diào)用哪個(gè)端點(diǎn)。
EndpointMiddleware 所有調(diào)用的端點(diǎn)。
它們?cè)谥虚g件管道中的兩個(gè)不同點(diǎn)處添加,因?yàn)樗鼈兤鹬鴥蓚€(gè)不同的作用。一般而言,我們想的是路由中間件提前在管道中,以便后續(xù)的中間件可以訪問有關(guān)將執(zhí)行的端點(diǎn)的信息。端點(diǎn)的調(diào)用應(yīng)在管道的末端進(jìn)行。
如下所示:
public void Configure(IApplicationBuilder app, IWebHostEnvironment env) { if (env.IsDevelopment()) { app.UseDeveloperExceptionPage(); } app.UseHttpsRedirection(); app.UseRouting(); app.UseAuthorization(); app.UseEndpoints(endpoints => { endpoints.MapControllers(); }); }
該UseRouting()擴(kuò)展方法添加EndpointRoutingMiddleware到管道,同時(shí)將UseEndpoints()擴(kuò)展方法添加EndpointMiddleware到管道。UseEndpoints()實(shí)際上為應(yīng)用程序注冊(cè)所有端點(diǎn)的位置。
那么如何將我們自定義中間件使用端點(diǎn)路由來映射呢?
從概念上講,我們UseEndpoints()使用/OrderURL作為匹配的路徑,將“order”端點(diǎn)的注冊(cè)移動(dòng)到調(diào)用中:
endpoints.MapControllers(); endpoints.Map("/order",endpoints.CreateApplicationBuilder() .UseMiddleware<ApiEndpointMiddleware>().Build()).WithDisplayName("order-api");
在我們上面針對(duì)ASP.NET Core 2.x的實(shí)現(xiàn)中,我們將匹配/order,/order/123等端點(diǎn)路由
例如:
endpoints.Map("/order/{action}",null);
這將同時(shí)匹配 /order /order/1,但不匹配/order/status/1。它比以前的版本功能強(qiáng)大得多.
在上一個(gè)示例中,我們提供了一個(gè)顯示名稱(主要用于調(diào)試目的),但是我們可以附加其他的信息,例如授權(quán)策略或CORS策略,其他中間件可以查詢這些信息。例如:
app.UseEndpoints(endpoints => { endpoints.MapControllers(); endpoints.Map("/order/{action}",endpoints.CreateApplicationBuilder() .UseMiddleware<ApiEndpointMiddleware>().Build()).WithDisplayName("order-api").RequireCors("AllowAllHosts") .RequireAuthorization("AdminOnly"); });
我們向端點(diǎn)添加了CORS策略(AllowAllHosts)和授權(quán)策略(AdminOnly)。當(dāng)?shù)竭_(dá)端點(diǎn)的請(qǐng)求到達(dá)時(shí),并在執(zhí)行端點(diǎn)之前采取相應(yīng)的措施。
感謝各位的閱讀!關(guān)于“ASP.NET Core3.X終端中間件如何轉(zhuǎn)換為端點(diǎn)路由運(yùn)行”這篇文章就分享到這里了,希望以上內(nèi)容可以對(duì)大家有一定的幫助,讓大家可以學(xué)到更多知識(shí),如果覺得文章不錯(cuò),可以把它分享出去讓更多的人看到吧!
網(wǎng)頁標(biāo)題:ASP.NETCore3.X終端中間件如何轉(zhuǎn)換為端點(diǎn)路由運(yùn)行-創(chuàng)新互聯(lián)
鏈接地址:http://www.rwnh.cn/article24/dohsje.html
成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián),為您提供企業(yè)網(wǎng)站制作、做網(wǎng)站、自適應(yīng)網(wǎng)站、商城網(wǎng)站、Google、網(wǎng)站制作
聲明:本網(wǎng)站發(fā)布的內(nèi)容(圖片、視頻和文字)以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主,如果涉及侵權(quán)請(qǐng)盡快告知,我們將會(huì)在第一時(shí)間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng),如需處理請(qǐng)聯(lián)系客服。電話:028-86922220;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時(shí)需注明來源: 創(chuàng)新互聯(lián)
猜你還喜歡下面的內(nèi)容