概述
早先提及了端点路由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;
你可以在项目中这样写:
endpoints.MapControllerRoute(
name:"default",
pattern:"{controller=Home}/{action=index}/{id?}"
);
如果请求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”来特指“约定路由”会误导开发者。
最后
以上就是醉熏衬衫为你收集整理的ASP.NET Core端点路由中三种路由函数的全部内容,希望文章能够帮你解决ASP.NET Core端点路由中三种路由函数所遇到的程序开发问题。
如果觉得靠谱客网站的内容还不错,欢迎将靠谱客网站推荐给程序员好友。
发表评论 取消回复