深入解析ASP.NET Core MVC路由机制：从基础到高级应用-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00802/article/details/148417102

深入解析ASP.NET Core MVC路由机制：从基础到高级应用

practical-aspnetcore 该项目提供了关于ASP.NET Core实际应用开发的一系列教程和示例，涵盖了从基础知识到高级主题，是一个实用的学习资源库。适合于想要掌握ASP.NET Core技术栈的开发者进行学习和参考。项目地址: https://gitcode.com/gh_mirrors/pr/practical-aspnetcore

前言

在ASP.NET Core MVC框架中，路由系统是连接HTTP请求与控制器动作的桥梁。本文将基于一个专注于ASP.NET Core实践的系列项目，全面剖析MVC路由的各种使用场景和技术细节，帮助开发者掌握路由配置的核心要点。

路由基础概念

路由系统负责将传入的URL映射到特定的控制器动作方法。ASP.NET Core提供了两种主要的路由方式：

传统路由(Conventional Routing)：基于模式匹配的集中式配置
属性路由(Attribute Routing)：通过装饰器直接在控制器和动作上定义

传统路由详解

基本固定路由配置

最基本的传统路由配置方式是在Startup类中直接指定固定模式：

endpoints.MapControllerRoute(
    name: "fixed",
    pattern: "home/index",
    defaults: new { controller = "Home", action = "Index" });

这种配置将URL"home/index"精确映射到HomeController的Index方法。

默认约定路由

更常见的做法是使用默认约定路由：

endpoints.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

这种模式提供了灵活的URL结构，其中：

controller：指定控制器名称，默认为Home
action：指定动作方法名称，默认为Index
id：可选参数

ASP.NET Core还提供了简化方法：

endpoints.MapDefaultControllerRoute();

这一行代码等价于上面的默认约定路由配置。

属性路由进阶

控制器级路由属性

最简单的属性路由是在控制器类上使用[Route]：

[Route("products")]
public class ProductsController : Controller
{
    public IActionResult List() { ... }
}

这种配置下，控制器只能包含一个动作方法，因为所有请求都会路由到该方法。

动作方法级路由属性

更实用的方式是在动作方法上使用路由属性：

[Route("products")]
public class ProductsController : Controller
{
    [Route("list")]
    public IActionResult List() { ... }
    
    [Route("details/{id}")]
    public IActionResult Details(int id) { ... }
}

这样可以在一个控制器中定义多个动作方法，每个方法有自己的路由路径。

HTTP方法限定属性

除了[Route]，还可以使用HTTP方法特定的属性：

[HttpGet("products/list")]
public IActionResult List() { ... }

[HttpPost("products/create")]
public IActionResult Create() { ... }

这些属性不仅定义路由，还限定了HTTP方法类型，使API设计更加清晰。

路由令牌与高级技巧

控制器和动作名称令牌

使用[controller]和[action]令牌可以自动引用控制器和动作名称：

[Route("[controller]")]
public class ProductsController : Controller
{
    [HttpGet("[action]")]
    public IActionResult List() { ... }
}

生成的URL将自动匹配控制器和动作名称，提高代码的可维护性。

动作约束接口

当存在多个同名动作方法时，可以使用IActionConstraint解决歧义：

public class CountrySpecificAttribute : Attribute, IActionConstraint
{
    private readonly string _country;
    
    public CountrySpecificAttribute(string country) 
    {
        _country = country;
    }
    
    public bool Accept(ActionConstraintContext context)
    {
        return string.Equals(
            context.RouteContext.HttpContext.Request.Headers["Country"],
            _country,
            StringComparison.OrdinalIgnoreCase);
    }
}

[CountrySpecific("us")]
public IActionResult About() { ... }

[CountrySpecific("uk")]
public IActionResult About() { ... }

通过自定义约束，可以根据请求头中的国家信息路由到不同的About方法。