ASP.NET Core中三个egg疼的路由函数

简介: ASP.NET Core中三个egg疼的路由函数

端点路由app.UseEndpoints强调的是端点和路由,它的核心目的是将请求落地点与路由寻址方式解耦。在这里面有几个比较容易混淆的函数:


  • MapControllerRoute
  • MapDefaultControllerRoute
  • MapControllers


我相信很多开发人员不清楚它们有什么不同,以及该在什么时候用哪个。那么下面我们就来学习一下吧。


1.MapControllerRoute

它的官方定义是这样的,将控制器操作的终结点添加到Microsoft.AspNetCore.Routing.IEndpointRouteBuilder里,并指定具有给定名称、模式、默认值、约束和 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项目初期的写法,让用户发送请求的url去匹配Controller和Action。


但是约定路由并不非主流,这是因为约定路由对于用户来说并不友好,并且暴露了后端开发者定义的Controller和Action名称。而且实际上不应该让用户的url去匹配Controller和Action名称,应该让开发者去匹配用户想要使用的url,这样就是特性路由。


2.MapDefaultControllerRoute

官方的定义是这样的:将控制器操作的终结点添加到Microsoft.AspNetCore.Routing.IEndpointRouteBuilder中,并添加默认路由 {controller=Home}/{action=Index}/{id?}。

endpoints.MapDefaultControllerRoute()是上面约定路由的默认样例.


3.MapControllers

官方定义是这样的:将控制器操作的终结点添加到 Microsoft.AspNetCore.Routing.IEndpointRouteBuilder中,并且不指定任何路由。不对约定路由做任何假设,也就是说不使用约定路由,而是依赖用户的特性路由, 它一般用在WebAPI项目中。


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


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


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


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


目录
相关文章
|
11天前
|
开发框架 .NET 开发者
简化 ASP.NET Core 依赖注入(DI)注册-Scrutor
Scrutor 是一个简化 ASP.NET Core 应用程序中依赖注入(DI)注册过程的开源库,支持自动扫描和注册服务。通过简单的配置,开发者可以轻松地从指定程序集中筛选、注册服务,并设置其生命周期,同时支持服务装饰等高级功能。适用于大型项目,提高代码的可维护性和简洁性。仓库地址:<https://github.com/khellang/Scrutor>
34 5
|
29天前
|
开发框架 .NET C#
在 ASP.NET Core 中创建 gRPC 客户端和服务器
本文介绍了如何使用 gRPC 框架搭建一个简单的“Hello World”示例。首先创建了一个名为 GrpcDemo 的解决方案,其中包含一个 gRPC 服务端项目 GrpcServer 和一个客户端项目 GrpcClient。服务端通过定义 `greeter.proto` 文件中的服务和消息类型,实现了一个简单的问候服务 `GreeterService`。客户端则通过 gRPC 客户端库连接到服务端并调用其 `SayHello` 方法,展示了 gRPC 在 C# 中的基本使用方法。
39 5
在 ASP.NET Core 中创建 gRPC 客户端和服务器
|
19天前
|
开发框架 缓存 .NET
GraphQL 与 ASP.NET Core 集成:从入门到精通
本文详细介绍了如何在ASP.NET Core中集成GraphQL,包括安装必要的NuGet包、创建GraphQL Schema、配置GraphQL服务等步骤。同时,文章还探讨了常见问题及其解决方法,如处理复杂查询、错误处理、性能优化和实现认证授权等,旨在帮助开发者构建灵活且高效的API。
24 3
|
3月前
|
开发框架 前端开发 JavaScript
ASP.NET MVC 教程
ASP.NET 是一个使用 HTML、CSS、JavaScript 和服务器脚本创建网页和网站的开发框架。
48 7
|
3月前
|
存储 开发框架 前端开发
ASP.NET MVC 迅速集成 SignalR
ASP.NET MVC 迅速集成 SignalR
79 0
|
4月前
|
开发框架 前端开发 .NET
ASP.NET MVC WebApi 接口返回 JOSN 日期格式化 date format
ASP.NET MVC WebApi 接口返回 JOSN 日期格式化 date format
56 0
|
4月前
|
开发框架 前端开发 安全
ASP.NET MVC 如何使用 Form Authentication?
ASP.NET MVC 如何使用 Form Authentication?
|
4月前
|
开发框架 .NET
Asp.Net Core 使用X.PagedList.Mvc.Core分页 & 搜索
Asp.Net Core 使用X.PagedList.Mvc.Core分页 & 搜索
145 0
|
7月前
|
开发框架 前端开发 .NET
ASP.NET CORE 3.1 MVC“指定的网络名不再可用\企图在不存在的网络连接上进行操作”的问题解决过程
ASP.NET CORE 3.1 MVC“指定的网络名不再可用\企图在不存在的网络连接上进行操作”的问题解决过程
212 0
|
7月前
|
开发框架 前端开发 JavaScript
JavaScript云LIS系统源码ASP.NET CORE 3.1 MVC + SQLserver + Redis医院实验室信息系统源码 医院云LIS系统源码
实验室信息系统(Laboratory Information System,缩写LIS)是一类用来处理实验室过程信息的软件,云LIS系统围绕临床,云LIS系统将与云HIS系统建立起高度的业务整合,以体现“以病人为中心”的设计理念,优化就诊流程,方便患者就医。
87 0