在ASP.NET Core MVC中,路由是一项核心功能,它负责将进来的HTTP请求映射到相应的控制器和动作方法上。ASP.NET Core支持两种路由方式:传统的基于模板的路由(约定路由)和属性路由。
1. 基于约定的路由
在Startup.Configure
方法中配置应用程序使用MVC,并定义路由规则。这种方式通常在app.UseEndpoints
中进行设置。
csharp
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
// 省略中间件配置
app.UseRouting();
app.UseEndpoints(endpoints =>
{
// 默认路由规则
endpoints.MapControllerRoute(
name: "default",
pattern: "{controller=Home}/{action=Index}/{id?}");
});
}
在这个例子中,定义了一个默认路由,它将请求映射到相应的控制器和方法上。如果请求没有指定控制器或动作,则默认使用Home
控制器的Index
方法。
2. 属性路由
属性路由允许通过在控制器或动作方法上应用特定的属性来直接在它们上面定义路由。这提供了更高的灵活性和控制。
csharp
[Route("api/[controller]")]
public class ProductsController : Controller
{
[HttpGet]
public IActionResult GetAll()
{
// 实现省略
}
[HttpGet("{id}")]
public IActionResult Get(int id)
{
// 实现省略
}
[HttpPost]
public IActionResult Create([FromBody] Product product)
{
// 实现省略
}
}
在这个例子中,ProductsController
的基础路由是api/products
。这是通过将[Route("api/[controller]")]
属性应用于控制器类来实现的。随后,针对控制器中的不同操作定义了更具体的路由。
混合使用
ASP.NET Core允许在同一个应用中同时使用基于约定的路由和属性路由。你可以根据具体情况选择最适合的路由策略。在很多情况下,属性路由提供了更高的灵活性,特别是在构建RESTful API时,而基于模板的路由则适用于更传统的MVC应用程序。
注意事项
- 确保路由配置不会产生冲突,否则可能导致无法预期的路由行为。
- 对于RESTful API设计,推荐使用属性路由,因为它们允许在路由层次结构中提供更清晰的API端点定义。
- 从.NET Core 3.0开始,推荐在
Startup.Configure
方法中使用app.UseEndpoints
来配置路由,这代表了一种更灵活的路由配置方式。
路由是连接用户请求和应用程序处理逻辑的桥梁,合理设计路由可以提升应用的可用性和易维护性。