ASP.NET Core端点路由中三种让人困惑的路由函数

商务办公
早先提及了端点路由app.UseEndpoints, 端点路由强调的是端点和路由,其核心目的是将请求落地点与路由寻址方式解耦。

 [[419724]]

早先提及了端点路由app.UseEndpoints, 端点路由强调的是端点和路由,其核心目的是将请求落地点与路由寻址方式解耦。

《ASP.NET Core端点路由作用原理》

这里面有几个容易混淆的函数

  • MapControllerRoute
  • MapDefaultControllerRoute
  • MapControllers

有什么不同?什么时候该用哪一个?

1. MapControllerRoute

Adds endpoints for controller actions to the Microsoft.AspNetCore.Routing.IEndpointRouteBuilder and specifies a route with the given name, pattern, defaults, constraints, and dataTokens.

约定路由(conventional routing), 通常用在MVC项目中;

需要传参name pattern defaults constraints dataTokens;

你可以在项目中这样写:

  1. endpoints.MapControllerRoute( 
  2.   name:"default"
  3.   pattern:"{controller=Home}/{action=index}/{id?}" 
  4. ); 

如果请求url满足 {host}{controller_name}{action_name}{option_id} , 将命中Controller=controller_name Action=action_name的方法体;如果url不提供controller、action名称,默认命中home/index 方法体。

说到底这种写法:

是MVC web项目的早期写法,让用户请求的url去匹配开发者的Controller-Action名称。

如今约定路由并不是主流,因为所谓的约定路由对于用户浏览并不友好,而且暴露了后端开发者定义的琐碎的Controller、Action名称。

实际上,不应该让用户的url去匹配开发者定义的Controller-Action名称(太丑陋的行为),而应该让开发者去匹配用户想要使用的url, 这样特性路由出现了。

2. MapDefaultControllerRoute

Adds endpoints for controller actions to the Microsoft.AspNetCore.Routing.IEndpointRouteBuilder and adds the default route {controller=Home}/{action=Index}/{id?}.

endpoints.MapDefaultControllerRoute(); 正是上面约定路由的默认样例,这没什么好聊的。

3. MapControllers

Adds endpoints for controller actions to the Microsoft.AspNetCore.Routing.IEndpointRouteBuilder without specifying any routes.

不对约定路由做任何假设,也就是不使用约定路由,依赖用户的特性路由, 一般用在WebAPI项目中。

全文梳理就会发现: 官方英文描述屡次出现的route,其实特指的是约定路由。

这样的描述我其实是不苟同的:

路由在.NET里面, 已经被普世认定为“约定路由”和“特性路由”,基于这种认知,我读了好几遍官方英文描述,其实没读出个所以然的。

官方英文描述使用 “route”来特指“约定路由”会误导开发者。

https://github.com/dotnet/aspnetcore/blob/main/src/Mvc/Mvc.Core/src/Builder/ControllerEndpointRouteBuilderExtensions.cs

责任编辑:武晓燕 来源: 精益码农
相关推荐

2024-03-15 11:35:11

配置文件应用程序开发

2009-08-03 17:41:20

ASP.NET Cac

2009-07-29 11:44:30

ASP.NET缓存Cache

2014-08-21 09:31:06

路由

2009-07-22 15:02:02

ASP.NET MVC

2013-05-31 10:36:56

ASP.net文件上传

2015-01-07 09:32:50

ASP.NET MVC路由

2010-03-12 09:38:58

2021-02-19 06:54:33

配置系统ASP.NET Cor

2009-12-09 09:48:38

solaris静态路由

2022-07-22 20:00:01

高可用路由

2018-08-20 08:03:46

跨平台 Web操作系统

2012-03-19 10:17:19

ASP.NET

2009-11-10 13:19:09

动态路由协议

2010-08-23 17:05:38

DHCP中继

2022-06-13 09:05:33

Ramda函数签名

2021-03-04 11:10:29

容器化Docker虚拟机

2009-12-10 15:46:22

动态路由协议

2009-07-22 15:27:39

ASP.NET MVC自定义路由

2021-03-12 00:04:52

网关Api
点赞
收藏

51CTO技术栈公众号