ICode9

精准搜索请尝试: 精确搜索
首页 > 其他分享> 文章详细

.Net Core 路由处理

2021-04-10 14:32:27  阅读:190  来源: 互联网

标签:Core Index app 中间件 Net endpoints public 路由


  用户请求接口路由,应用返回处理结果。应用中如何匹配请求的数据呢?为何能如此精确的找到对应的处理方法?今天就谈谈这个路由。路由负责匹配传入的HTTP请求,将这些请求发送到可以执行的终结点。终结点在应用中进行定义并且在应用启动的时候进行配置,也就是在中间件中进行处理。

路由基础知识

优惠券 https://www.fenfaw.cn/   在项目新建的时候都会自动生成路由相关代码。在 Startup.Configure中的中间件管道注册的。主要涉及到的则是 UseRoutingUseEndpoints中间件。      UseRouting向中间件添加路由匹配。此中间件还会查看应用中定义的终结点集。也就是把应用中的路由统统注册到中间件管道,方便请求的时候进行匹配。      UseEndpoints向中间件添加终结点执行。会运行相关联的委托。简单将就是路由匹配之后的处理事件运行。
        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }

            app.UseRouting();

            app.UseEndpoints(endpoints =>
            {
                endpoints.MapGet("/", async context =>
                {
                    await context.Response.WriteAsync("Hello World!");
                });
            });
        }

 

  例如上面的代码就是 HTPP GET 请求并且Url是/的时候需要执行的委托、如果这里的请求不是 Get请求或者不是"/",那么没有路由匹配,则会返回404。同时指定匹配模式的还有 MapDelete、MapMethods、MapPost、MapPut、Map等。

终结点

  上面讲的 MapGet或者未用到 MapPost等就是用于定义终结点的。它们都包含有两个参数,一个是用于 Url匹配的,另外一个就是需要执行的委托。这里在不一样的应用中都采用了不同的终结点定义方法
    • 用于 Razor Pages 的 MapRazorPages
    • 用于控制器的 MapControllers
    • 用于 SignalR 的 MapHub
    • 用于 gRPC 的 MapGrpcService
  那么我们如果需要使用到了授权模块将如何处理呢,终结点也有相对应的处理方式。下面就展示将授权中间件和路由一起使用, MapHealthChecks添加运行状况检查终结点。后面跟着的 RequireAuthorization则是将授权策略添加到端点。   
           app.UseRouting();

            app.UseAuthentication();
            app.UseAuthorization();

            app.UseEndpoints(endpoints =>
            {
                endpoints.MapHealthChecks("/healthz").RequireAuthorization();
                endpoints.MapGet("/", async context =>
                {
                    await context.Response.WriteAsync("Hello World!");
                });
            });

 

  而且我们看中间的使用顺序, UseAuthentication、UseAuthorization是穿插在 UseRoutingUseEndpoints中间的,如此写法则是为了授权策略能在 UseRouting中查找终结点,但是能在 UseEndpoints发送到终结点执行之前应用所选择的授权策略

终结点元数据

  上面的示例展示了运行状况检查终结点附加了授权策略。添加的授权策略是额外数据,也就是终结点元数据。
    • 可以通过路由感知中间件来处理元数据。
    • 元数据可以是任意的 .NET 类型。
  上面提到元数据可以是人意的.NET类型,那么具体到底是什么呢?元数据如何使用呢?
         // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }

            app.UseRouting();

            app.Use(next => context =>
            {
                var endpoint = context.GetEndpoint();
                if (endpoint?.Metadata.GetMetadata<AuditPolicyAttribute>()?.NeedsAudit ==true)
                {
                    Console.WriteLine("开始处理事务逻辑");
                    Console.WriteLine($"ACCESS TO SENSITIVE DATA AT: {DateTime.UtcNow}");
                }
                return next(context);
            });

            app.UseEndpoints(endpoints =>
            {
                endpoints.MapGet("/", async context =>
                {
                    await context.Response.WriteAsync("Hello world!");
                });

                // Using metadata to configure the audit policy.
                endpoints.MapGet("/sensitive", async context =>
                {
                    await context.Response.WriteAsync($"sensitive data{DateTime.UtcNow}");
                })
                .WithMetadata(new AuditPolicyAttribute(needsAudit: true));
            });
        }
    }

    public class AuditPolicyAttribute : Attribute
    {
        public AuditPolicyAttribute(bool needsAudit)
        {
            NeedsAudit = needsAudit;
        }

        public bool NeedsAudit { get; }
    }
  看上面的示例中,在终结点绑定 "/sensitive"的时候会附加元数据 WithMetadata。当访问“/”的时候会输出 "Hello world!"。但是在 app.Use中并不会执行输出"处理事务逻辑",因为并没有匹配的元数据。但是当执行 "/sensitive"的时候就会输出 Console.WriteLine("开始处理事务逻辑");。因为在终结点定义的时候添加了元数据。元数据可以是人意.NET类型。上面的元数据也是我们自定义 Class

比较终端中间件和路由

  上面我们使用app.Use来检测匹配元数据,如果匹配成功我们就执行对应的操作。我们称之为终端中间件,为什么是终端中间件呢,因为这里会停止搜索执行匹配和操作、最后返回。   那么相比较下终端中间件和路由有什么区别呢?
    • 这两种方法都允许终止处理管道:终端中间件允许在管道中的任意位置放置中间件:
      • 中间件通过返回而不是调用 next 来终止管道。
      • 终结点始终是终端。
    • 终端中间件允许在管道中的任意位置放置中间件:

        • 终结点在 UseEndpoints 位置执行。
      • 终端中间件允许任意代码确定中间件匹配的时间:
        • 自定义路由匹配代码可能比较复杂,且难以正确编写。
        • 路由为典型应用提供了简单的解决方案。 
        • 大多数应用不需要自定义路由匹配代码。
      • 带有中间件的终结点接口,如 UseAuthorization 和 UseCors。
        • 通过 UseAuthorization 或 UseCors 使用终端中间件需要与授权系统进行手动交互

      设置传统路由

        上面我们知道了通过UseRouting向中间件添加路由匹配,然后通过UseEndpoints定义终结点去执行匹配委托。那么在MVC模式中如何设置呢?我们看看传统路由的设置方法。
               app.UseEndpoints(endpoints =>
                  {
                      app.UseEndpoints(endpoints =>
                      {
                          endpoints.MapControllerRoute(
                              name: "default",
                              pattern: "{controller=Home}/{action=Index}/{id?}");
                      });
                  });
        上面我们设置传统路由的时候采用的是endpoints.MapControllerRoute();,其中附带有两个参数,一个是名称default,第二个则是路由模板。我们看路由模板{controller=Home}/{action=Index}/{id?},那么在匹配Url路径的时候,例如执行路径 WeatherForecast/Index/5。那么则会匹配控制器为WeatherForecast,其中方法是Index并且参数是int类型的一个处理方法。

      REST Api 的属性路由

        上面讲的是传统路由设置,那么对于Api项目的路由设置是如何的呢?REST Api 应使用属性路由将应用功能建模为一组资源。我们看下示例代码   
           // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
              public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
              {
                  if (env.IsDevelopment())
                  {
                      app.UseDeveloperExceptionPage();
                  }
      
                  app.UseRouting();
      
                  app.UseAuthorization();
      
                  app.UseEndpoints(endpoints =>
                  {
                      endpoints.MapControllers();
                  });
              }
        在上面的代码中使用MapControllers调用。映射属性路由。我们看在使用的时候属性路由的使用方式。
      1. Route[]
            下面的示例中我们采用的是Route[]的方式,它既可单独作用域控制器也可单独作用域action。也可同时使用。
        [ApiController]
          [Route("[controller]")]
          public class WeatherForecastController : ControllerBase
          {
      
              [Route("Index")]
              public string Index(int? id)
              {
                  return "Test";
              }
          }
          [ApiController]
          [Route("[controller]/[action]")]
          public class WeatherForecastController : ControllerBase
          {
              public string Index(int? id)
              {
                  return "Test";
              }
          }
          [ApiController]
          public class WeatherForecastController : ControllerBase
          {
              [Route("[controller]/Index")]
              public string Index(int? id)
              {
                  return "Test";
              }
          }
      1. Http[Verb]
            采用Http[Verb]的方式那就仅仅能作用在action上了。比如下面的就直接在Index上方写 [HttpGet("[controller]/Index")],其他就是 HttpPost、HttpDelete等等操作
         [ApiController]
          public class WeatherForecastController : ControllerBase
          {
              [HttpGet("[controller]/Index")]
              public string Index(int? id)
              {
                  return "Test";
              }
          }
      1. Route[]和Http[Verb]混合使用
            有时在实际运用中也可以采取两种方式混合使用的,例如下面的示例在控制器采用Route[],在action采用Http[Verb]。因为一般定义Api的时候我们不仅要标注action名称,我们还需要知道action的请求方式。
        [ApiController]
          [Route("[controller]")]
          public class WeatherForecastController : ControllerBase
          {
      
              [HttpGet("Index")]
              public string Index(int? id)
              {
                  return "Test";
              }
          }

       

       

标签:Core,Index,app,中间件,Net,endpoints,public,路由
来源: https://blog.csdn.net/weixin_48967543/article/details/115574369

本站声明: 1. iCode9 技术分享网(下文简称本站)提供的所有内容,仅供技术学习、探讨和分享;
2. 关于本站的所有留言、评论、转载及引用,纯属内容发起人的个人观点,与本站观点和立场无关;
3. 关于本站的所有言论和文字,纯属内容发起人的个人观点,与本站观点和立场无关;
4. 本站文章均是网友提供,不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属;如您发现该文章侵犯了您的权益,可联系我们第一时间进行删除;
5. 本站为非盈利性的个人网站,所有内容不会用来进行牟利,也不会利用任何形式的广告来间接获益,纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。

专注分享技术,共同学习,共同进步。侵权联系[81616952@qq.com]

Copyright (C)ICode9.com, All Rights Reserved.

ICode9版权所有