今天就跟大家聊聊有关ASP.NET Core 2.2中Endpoint路由的作用是什么,可能很多人都不太了解,为了让大家更加了解,小编给大家总结了以下内容,希望大家根据这篇文章可以有所收获。
成都创新互联公司是专业的融水网站建设公司,融水接单;提供成都网站设计、成都网站建设,网页设计,网站设计,建网站,PHP网站建设等专业做网站服务;采用PHP框架,可快速的进行融水网站开发网页制作和功能扩展;专业做搜索引擎喜爱的网站,专业的做网站团队,希望更多企业前来合作!Endpoint路由
在ASP.NET Core 2.2中,新增了一种路由,叫做 Endpoint (终结点)路由。本文将以往的路由系统称为 传统路由 。
本文通过源码的方式介绍传统路由和 Endpoint 路由部分核心功能和实现方法,具体功能上的差异见 官方文档 。
在升级到ASP.NET Core 2.2后,会自动启用 Endpoint 路由。如果要恢复以往的实现逻辑,需要加入以下代码:
services.AddMvc(options => options.EnableEndpointRouting = false) .SetCompatibilityVersion(CompatibilityVersion.Version_2_2);
本文分析的源代码基于ASP.NET Core 2.2.3版本的 源代码 。
Endpoint作用
Endpoint 路由与传统路由的区别在于,传统路由 Url 与 Action 对应关系的处理是在 UseMvc 中做的。我们无法根据 Url 获取对应的 Action 然后进行处理。
Endpoint 就是将 Url 与 Action 的映射关系从 Mvc 中拆离,作为独立使用的中间件。
由此带来的好处是我们可以在其他的中间件中使用 Controller 和 Action 上的一些信息,例如 Attruibute 。
框架也提供了 LinkGenerator 类来直接根据 Endpoint 生成链接,不再需要 HttpContext 的信息。
另外也提升了一些RPS(Requests per Second)。
不过目前 Endpoint 依然是在 UseMvc 中调用,更多开放的使用方式会在ASP.NET Core 3.0中实现。
启用Endpoint路由
源代码见 Github 。也可以获取源代码到本地看。
在 MvcApplicationBuilderExtensions.cs 文件72行的 UseMvc 方法中我们可以看到以下代码:
var options = app.ApplicationServices.GetRequiredService>(); if (options.Value.EnableEndpointRouting) { ... } else { ... }
if 之中是 Endpoint 路由的逻辑, else 是传统路由的逻辑。
而 MvcOptions 的构造方法如下所示, EnableEndpointRouting 是通过 CompatibilitySwitch 来控制默认值的,这就是 CompatibilityVersion.Version_2_2 启用 Endpoint 路由的原因。
public MvcOptions() { // ... _enableEndpointRouting = new CompatibilitySwitch(nameof(EnableEndpointRouting)); // ... }
Endpoint路由实现原理
在 MvcApplicationBuilderExtensions.cs 文件的92-123行的代码是将所有的 Controller 中的 Action 转换成 Endpoint 。
在129行的 UseEndpointRouting 中,添加了一个 EndpointRoutingMiddleware 的中间件,这个中间件就是从所有的 Endpoint 中找到当前路由对应的 Endpoint ,然后放到 Feature 集合中。
在132行的 UseEndpoint 中,添加了一个 EndpointMiddleware 中间件,这个中间件是将 EndpointRoutingMiddleware 中找到的 Endpoint 取出,根据其中的 MetaData 信息,找到对应的 Controller 和 Action ,并调用。
在 UseMvc 方法里, UseEndpointRouting 和 UseEndpoint 是连续的两个中间件,而 UseEndpoint 是请求的结束,这意味着我们自定义的中间件无法取得 Endpoint 信息。
但是通过手动调用 UseEndpoint ,我们还是可以拿到 Endpoint 路由信息的。
使用示例
下面展示一个使用示例。
定义一个 LogAttribute 类,并包含一个 Message 属性,在 Action 上声明使用。
定义一个 EndpointTestMiddleware 中间件,输出 LogAttribute 的 Message 属性。
手动调用 UseEndpointRouting ,然后调用我们定义的 EndpointTestMiddleware 中间件。
// Startup.cs public void Configure(IApplicationBuilder app, IHostingEnvironment env) { app.UseEndpointRouting(); app.UseMiddleware(); app.UseMvc(routes => { routes.MapRoute( name: "default", template: "{controller=Home}/{action=Index}/{id?}"); }); } // EndpointTestMiddleware.cs public class EndpointTestMiddleware { private RequestDelegate _next; public EndpointTestMiddleware(RequestDelegate next) { _next = next; } public async Task Invoke(HttpContext httpContext) { var endpoint = httpContext.Features.Get ()?.Endpoint; if (endpoint == null) { await _next(httpContext); return; } var attruibutes = endpoint.Metadata.OfType (); foreach (var attribute in attruibutes) { Debug.WriteLine("------------------------------------------------------------------------"); Debug.WriteLine(attribute.Message); Debug.WriteLine("------------------------------------------------------------------------"); } await _next(httpContext); } } // LogAttribute.cs [AttributeUsage(AttributeTargets.Method, Inherited = false, AllowMultiple = true)] public sealed class LogAttribute : Attribute { public LogAttribute(string message) { Message = message; } public string Message { get; set; } } // HomeController.cs public class HomeController : Controller { [Log("Index")] public IActionResult Index() { return View(); } [Log("Privacy")] public IActionResult Privacy() { return View(); } }
看完上述内容,你们对ASP.NET Core 2.2中Endpoint路由的作用是什么有进一步的了解吗?如果还想了解更多知识或者相关内容,请关注创新互联行业资讯频道,感谢大家的支持。