ASP.NET Core 由参数验证

在 ASP.NET Core Web API 中，你可以使用多种方式来自定义路由验证。这通常涉及到中间件（Middleware）、路由约束（Route Constraints）、模型绑定（Model Binding）和/或操作过滤器（Action Filters）。以下是一些建议的步骤和示例，说明如何根据你的需求实现自定义路由验证。

1. 使用路由约束

路由约束允许你指定路由参数必须满足的某些条件。例如，你可以使用内置的 int、bool、length 等约束，或者创建自定义约束。

[Route("api/[controller]")]
[ApiController]
public class MyController : ControllerBase
{
    // 使用内置的 int 约束
    [HttpGet("items/{id:int}")]
    public IActionResult GetItem(int id)
    {
        // ...
    }

    // 使用自定义约束（假设你有一个叫 MyCustomRouteConstraint 的类）
    [HttpGet("custom/{param:mycustom}")]
    public IActionResult GetCustomItem([FromRoute] string param)
    {
        // ...
    }
}

// 自定义路由约束示例
public class MyCustomRouteConstraint : IRouteConstraint
{
    public bool Match(HttpContext httpContext, IRouter route, string routeKey, RouteValueDictionary values, RouteDirection routeDirection)
    {
        // 实现你的验证逻辑
        // 例如，检查 values[routeKey] 是否满足某些条件
        if (routeDirection == RouteDirection.IncomingRequest && values.ContainsKey(routeKey))
        {
            var param = values[routeKey]?.ToString();
            // 假设我们只想接受以 "prefix-" 开头的参数
            return param?.StartsWith("prefix-") == true;
        }
        return false;
    }
}

2. 使用中间件

中间件可以在请求处理管道中的早期阶段进行验证。你可以创建一个中间件来检查请求的 URL，并在不符合要求时终止请求。

public class CustomRoutingValidationMiddleware
{
    private readonly RequestDelegate _next;

    public CustomRoutingValidationMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task InvokeAsync(HttpContext context)
    {
        // 检查请求的 URL 或其他条件
        var requestPath = context.Request.Path;
        if (!IsValidPath(requestPath)) // 实现你的验证逻辑
        {
            context.Response.StatusCode = StatusCodes.Status400BadRequest;
            await context.Response.WriteAsync("Invalid request path.");
            return;
        }

        // 否则，将请求传递给管道中的下一个中间件或终结点
        await _next(context);
    }

    private bool IsValidPath(string path)
    {
        // 实现你的验证逻辑
        return true; // 示例：始终返回 true，你应该替换为实际的验证逻辑
    }
}

// 在 Startup.cs 或 Program.cs 中配置中间件（取决于你的 ASP.NET Core 版本）

3. 使用模型绑定和验证

虽然模型绑定和验证通常用于请求体或查询字符串参数，但你也可以在路由参数上使用它们。通过创建自定义模型绑定器或利用现有的模型验证功能，你可以在绑定参数时执行验证。

4. 使用操作过滤器

操作过滤器允许你在执行操作之前或之后执行逻辑。你可以创建一个操作过滤器来检查路由参数，并在不满足条件时设置错误响应。

选择哪种方法取决于你的具体需求和偏好。通常，路由约束和模型绑定/验证是处理与路由参数相关的验证的常用方法。