资讯

精准传达 • 有效沟通

从品牌网站建设到网络营销策划,从策略到执行的一站式服务

ASP.NETCore3.X终端中间件如何转换为端点路由运行-创新互联

这篇文章给大家分享的是有关ASP.NET Core3.X终端中间件如何转换为端点路由运行的内容。小编觉得挺实用的,因此分享给大家做个参考,一起跟随小编过来看看吧。

青冈ssl适用于网站、小程序/APP、API接口等需要进行数据传输应用场景,ssl证书未来市场广阔!成为创新互联建站的ssl证书销售渠道,可以享受市场价格4-6折优惠!如果有意向欢迎电话联系或者加微信:18982081108(备注:SSL证书合作)期待与您的合作!

路由的进阶


路由负责将请求 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()); versionApp.UseMiddleware()); 

 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().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().Build()).WithDisplayName("order-api").RequireCors("AllowAllHosts")
   .RequireAuthorization("AdminOnly"); 
   });

我们向端点添加了CORS策略(AllowAllHosts)和授权策略(AdminOnly)。当到达端点的请求到达时,并在执行端点之前采取相应的措施。

感谢各位的阅读!关于“ASP.NET Core3.X终端中间件如何转换为端点路由运行”这篇文章就分享到这里了,希望以上内容可以对大家有一定的帮助,让大家可以学到更多知识,如果觉得文章不错,可以把它分享出去让更多的人看到吧!


分享标题:ASP.NETCore3.X终端中间件如何转换为端点路由运行-创新互联
URL分享:http://cdkjz.cn/article/dohsje.html
多年建站经验

多一份参考,总有益处

联系快上网,免费获得专属《策划方案》及报价

咨询相关问题或预约面谈,可以通过以下方式与我们联系

大客户专线   成都:13518219792   座机:028-86922220