ASP.NET Core 2.2中的Endpoint路由详解
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<IOptions<MvcOptions>>(); if (options.Value.EnableEndpointRouting) { ... } else { ... }
if 之中是 Endpoint 路由的逻辑, else 是传统路由的逻辑。
而 MvcOptions 的构造方法如下所示, EnableEndpointRouting 是通过 CompatibilitySwitch 来控制默认值的,这就是 CompatibilityVersion.Version_2_2 启用 Endpoint 路由的原因。
public MvcOptions() { // ... _enableEndpointRouting = new CompatibilitySwitch<bool>(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<EndpointTestMiddleware>(); 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<IEndpointFeature>()?.Endpoint; if (endpoint == null) { await _next(httpContext); return; } var attruibutes = endpoint.Metadata.OfType<LogAttribute>(); 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(); } }
这样的话,我们可以在我们自己的中间件中拿到 Endpoint 信息,然后找到 Controller 上的 LogAttribute ,然后输出 Message。
总结
Endpoint 是ASP.NET Core 2.2中一种新的路由机制,它解决了传统路由难以扩展的问题,解决了传统路由与MVC过于耦合的问题,并提升了一定的RPS。
本文介绍了Endpoint路由,简单分析了Endpoint的实现原理,并给出了一个使用的示例。
参考链接:
[ https://devblogs.microsoft.com/aspnet/asp-net-core-2-2-0-preview1-endpoint-routing/ ]
[ https://www.stevejgordon.co.uk/asp-net-core-first-look-at-global-routing-dispatcher ]
[ https://rolandguijt.com/endpoint-routing-in-asp-net-core-2-2-explained/ ]
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持猪先飞。
相关文章
- 这篇文章主要为大家详细介绍了ASP.NET购物车的实现过程,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下...2021-09-22
- 这篇文章主要介绍了vue 实现动态路由的方法,文中示例代码非常详细,帮助大家更好的理解和学习,感兴趣的朋友可以了解下...2020-07-06
- 这篇文章主要介绍了.NET Core下使用Kafka的方法步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-09-22
- 在开发过程中,使用Visual Studio的断点调试功能可以很方便帮我们调试发现程序存在的错误,同样Visual Studio也支持对SQL Server里面的存储过程进行调试,下面就让我们看看具体的调试方法。...2021-09-22
- 这篇文章主要介绍了详解.NET Core 3.0 里新的JSON API,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-09-22
ASP.NET Core根据环境变量支持多个 appsettings.json配置文件
这篇文章主要介绍了ASP.NET Core根据环境变量支持多个 appsettings.json配置文件,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-09-22- 这篇文章主要介绍了记一次EFCore类型转换错误及解决方案,帮助大家更好的理解和学习使用asp.net core,感兴趣的朋友可以了解下...2021-09-22
解决vue动态路由异步加载import组件,加载不到module的问题
这篇文章主要介绍了解决vue动态路由异步加载import组件,加载不到module的问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2020-07-27- 这篇文章主要介绍了解决vue-router路由拦截造成死循环问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2020-08-05
- 这篇文章主要给大家介绍了关于vue.js Router中嵌套路由的相关资料,所谓嵌套路由就是路由里面嵌套他的子路由,文章通过示例代码介绍的非常详细,需要的朋友可以参考下...2021-06-27
- 这篇文章主要介绍了vue-router路由参数刷新消失的问题...2017-06-24
详解ASP.NET Core 中基于工厂的中间件激活的实现方法
这篇文章主要介绍了ASP.NET Core 中基于工厂的中间件激活的实现方法,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下...2021-09-22- 这篇文章主要介绍了vue-router为激活的路由设置样式操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2020-07-18
- 这篇文章主要介绍了Vue鼠标滚轮滚动切换路由效果的实现方法,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下...2021-08-04
asp.net通过消息队列处理高并发请求(以抢小米手机为例)
这篇文章主要介绍了asp.net通过消息队列处理高并发请求(以抢小米手机为例),文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-09-22- Underscore 是一个 JavaScript 工具库,它提供了一整套函数式编程的实用功能,但是没有扩展任何 JavaScript 内置对象。这篇文章主要介绍了underscore源码分析相关知识,感兴趣的朋友一起学习吧...2016-01-02
- 这篇文章主要介绍了springboot中nacos动态路由的配置方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-09-11
ASP.NET单选按钮控件RadioButton常用属性和方法介绍
RadioButton又称单选按钮,其在工具箱中的图标为 ,单选按钮通常成组出现,用于提供两个或多个互斥选项,即在一组单选钮中只能选择一个...2021-09-22ASP.NET 2.0中的数据操作:使用两个DropDownList过滤的主/从报表
在前面的指南中我们研究了如何显示一个简单的主/从报表, 该报表使用DropDownList和GridView控件, DropDownList填充类别,GridView显示选定类别的产品. 这类报表用于显示具有...2016-05-19详解.NET Core 使用HttpClient SSL请求出错的解决办法
这篇文章主要介绍了.NET Core 使用HttpClient SSL请求出错的解决办法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧...2021-09-22