【ASP.NET Core 基础知识】--路由和请求处理--路由概念（二）

一、路由参数传递方式

1.1 查询字符串参数

在路由中，查询字符串参数是一种常见的方式传递信息。这种方式通过URL中的查询字符串（?key1=value1&key2=value2）将参数附加到请求中。在ASP.NET Core中，可以通过以下方式在控制器动作方法中接收查询字符串参数：

public class MyController : Controller
{
    public IActionResult MyAction()
    {
        // 通过Request对象获取查询字符串参数
        string parameter1 = HttpContext.Request.Query["param1"];

        // 或者通过动作方法的参数直接接收查询字符串参数
        public IActionResult MyAction(string param1, int param2)
        {
            // ...
        }

        // 示例URL：/MyController/MyAction?param1=value1&param2=42
    }
}

在上述例子中，查询字符串参数通过HttpContext.Request.Query对象获取，或者通过在动作方法的参数中直接声明，系统将自动进行参数绑定。这种方式对于传递较少且非敏感信息非常方便。

1.2 路由值参数

路由值参数是通过路由模板定义的占位符来捕获和传递的参数。在ASP.NET Core中，路由值参数通常由花括号 {} 包围，它们从URL中提取相应的值。以下是路由值参数的使用方式：

public class MyController : Controller
{
    // 路由模板包含{id}，它将作为路由值参数传递给动作方法
    [HttpGet("Products/{id}")]
    public IActionResult GetProductById(int id)
    {
        // 使用id参数执行相应的逻辑
    }

    // 示例URL：/Products/123
}

在上述例子中，{id}是一个路由值参数，它会从URL中匹配的位置提取相应的值传递给GetProductById方法的id参数。路由值参数的使用使得动作方法能够根据URL的结构动态地处理不同的请求。

1.3 表单参数

表单参数是通过HTML表单提交的数据，通常使用POST请求发送到服务器。在ASP.NET Core中，可以通过动作方法的参数直接接收表单参数。以下是处理表单参数的基本示例：

public class MyController : Controller
{
    // 显示表单页面
    [HttpGet]
    public IActionResult MyForm()
    {
        return View();
    }

    // 处理表单提交
    [HttpPost]
    public IActionResult MyForm(string username, string password)
    {
        // 使用接收到的表单参数执行相应的逻辑
        // username和password是表单中的input元素的name属性值
    }
}

在上述例子中，MyForm方法处理表单提交，通过参数username和password直接接收表单中相应元素的值。这种方式称为模型绑定，ASP.NET Core会自动将表单数据绑定到方法参数。

二、路由生成

2.1 使用UrlHelper生成URL

在ASP.NET Core中，UrlHelper是一个用于生成URL的实用程序类，它提供了生成各种类型URL的方法。以下是使用UrlHelper生成URL的基本示例：

public class MyController : Controller
{
    public IActionResult MyAction(int id)
    {
        // 使用UrlHelper生成URL
        string url = Url.Action("MyAction", "MyController", new { id = id });

        // 或者在视图中使用
        // string url = Url.Action("MyAction", "MyController", new { id = 42 });

        // 执行其他逻辑...
    }
}

在上述例子中，Url.Action方法用于生成MyController控制器中的MyAction动作方法的URL，同时传递了id参数。生成的URL将包含相应的路由信息。这样的方式非常灵活，可以确保生成的URL符合应用程序的路由规则。

2.2 命名路由

命名路由是为特定路由规则分配一个唯一的名称，以便在应用程序中引用和生成URL时使用。在ASP.NET Core中，可以通过在路由配置中使用name参数为路由指定名称。以下是使用命名路由的示例：

public class MyController : Controller
{
    // 命名路由配置
    [HttpGet("Products/{id}", Name = "ProductDetails")]
    public IActionResult GetProductById(int id)
    {
        // 执行相应的逻辑...
    }

    // 在其他地方引用命名路由
    public IActionResult AnotherAction()
    {
        // 通过命名路由生成URL
        string url = Url.RouteUrl("ProductDetails", new { id = 42 });

        // 执行其他逻辑...
    }
}

在上述例子中，HttpGet特性中的Name参数为路由指定了名称为ProductDetails。在AnotherAction方法中，可以使用Url.RouteUrl方法通过命名路由生成URL，确保生成的URL符合ProductDetails路由规则。这种方式在应用程序中的路由配置较复杂时非常有用。

三、区域化路由

在 ASP.NET Core 中，区域化路由是一种将应用程序分成多个区域，并为每个区域定义特定路由的技术。通过使用区域化路由，可以更好地组织和管理应用程序的不同部分，同时提高应用程序的可维护性和可扩展性。
区域化路由通常是在 Startup.cs 文件中配置的，具体来说，是在 Configure 方法中使用 MapAreaControllerRoute 或 MapAreaRoute 方法来定义区域路由。例如：

app.UseEndpoints(endpoints => {
    endpoints.MapControllerRoute(
        name: "default",
        pattern: "{controller=Home}/{action=Index}/{id?}"
    );
    endpoints.MapAreaControllerRoute(
        name: "areas",
        areaName: "admin",
        pattern: "{area:exists}/{controller=Home}/{action=Index}/{id?}"
    );
    endpoints.MapControllers();
});

在上述代码中，定义了一个名为 default 的路由，它对应于根区域的控制器。然后，使用 MapAreaControllerRoute 方法定义了一个名为 areas 的区域路由，该区域的名称为 admin，并为该区域的控制器定义了相应的路由规则。
另外，还可以通过在控制器上添加 Area 属性来指定该控制器属于哪个区域。例如：

[Area("admin")]
public class HomeController : Controller {}

这样，当请求到达该控制器时，ASP.NET Core 将根据 Area 属性的值将其路由到相应的区域。此配置允许通过URL指定语言/地区，例如/en-US/Home/Index，并在控制器和视图中使用本地化资源。

四、路由中间件

路由中间件在ASP.NET Core中起着关键作用，它负责根据传入的HTTP请求确定应该由哪个控制器的哪个动作方法来处理。以下是关于ASP.NET Core中路由中间件的一些关键概念：

1. 路由中间件的位置： 路由中间件通常位于中间件管道中的早期位置，以确保在请求到达控制器之前进行路由解析。
2. 路由模板： 路由中间件使用路由模板定义路由规则，其中包括控制器、动作方法以及其他可能的参数。
3. 默认路由： ASP.NET Core应用程序通常包含一个默认的路由规则，例如 {controller}/{action}/{id?}，其中{controller}表示控制器名，{action}表示动作方法名，{id?}表示可选的参数。
4. 路由参数： 路由参数可以从URL中提取，包括路由模板中的占位符，例如 {controller}、{action}、{id}。
5. 路由匹配： 路由中间件根据请求的URL和路由规则，确定应该由哪个控制器和动作方法处理。
6. 路由生成： 在应用程序中，可以使用Url.Action或Url.RouteUrl等方法通过路由生成器生成URL，确保符合路由规则。

// 通过路由生成器生成URL
string url = Url.Action("Index", "Home", new { id = 42 });

7. 路由约束： 路由中间件支持使用约束来限制参数的格式、长度、范围等，以确保路由匹配的精确性。
8. 区域路由： 路由中间件也支持区域路由，通过在路由规则中包含 {area} 占位符来实现。

[Area("Admin")]
public class AdminController : Controller
{
    // ...
}

总体而言，路由中间件在ASP.NET Core中是非常关键的一部分，它使得应用程序能够根据传入的请求路由到正确的控制器和动作方法，实现灵活的URL处理和路由规则。

五、总结

总体而言，深入了解了如何优雅地组织和处理Web应用的URL结构，提升了应用的可维护性和灵活性。