引言

前幾天.NET Core3.1發(fā)布,于是我把公司一個(gè)基礎(chǔ)通用系統(tǒng)升級(jí)了,同時(shí)刪除了幾個(gè)基礎(chǔ)模塊當(dāng)然這幾個(gè)基礎(chǔ)模塊與.NET Core3.1無關(guān)，其中包括了支付模塊，升級(jí)完后靜文（同事）問我你把支付刪除了??？我說是啊，沒考慮好怎么加上(感覺目前不太好，我需要重新設(shè)計(jì)一下)。

故事從這開始

考慮支付的時(shí)候我考慮的是將支付sdk如何直接引入到系統(tǒng)，以及可以有一系列支付的路由，我需要考慮的是如果創(chuàng)建響應(yīng)給指定的地址，so我開始想如何達(dá)到我的目的自定義個(gè)中間件，Use、Run、Map???

路由的進(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)的措施。

參考

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

以上就是本文的全部內(nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評(píng)論