public class EnumConstraint : IRouteConstraint { private Type _enumType; public EnumConstraint(string enumTypeName) { _enumType = Type.GetType(enumTypeName); } public bool Match(HttpContext httpContext, IRouter route, string routeKey, RouteValueDictionary values, RouteDirection routeDirection) { var value = values[routeKey]; if (value == null) { return false; } if (Enum.TryParse(_enumType, value.ToString(), out object result)) { if (Enum.IsDefined(_enumType, result)) { return true; } } return false; } }
在 Startup.cs 的 ConfigureServices 方法添加自定义约束：
services.Configure<RouteOptions>(options => { options.ConstraintMap.Add("enum", typeof(EnumConstraint)); });
在路由上使用约束：
( WebApplicationTest 是当前的 namespace )
[Route("api/[controller]")] [ApiController] public class TestController : ControllerBase { // GET: api/Test [HttpGet("{bool:enum(" + nameof(WebApplicationTest) + "." + nameof(BoolEnum) + ")}")] public string Get(BoolEnum @bool) { return "bool: " + @bool; } [HttpGet("{id:int:min(2)}", Name = "Get")] public string Get(int id) { return "id: " + id; } [HttpGet("{name}")] public string Get(string name) { return "name: " + name; } }
{id:int:min(2)} 路由必须使用 min(2) ，否则对于 id = 0 或 id = 1 会有冲突。
运行程序，当路由是 api/Test/0 、 api/Test/1 、 api/Test/True 和 api/Test/False 的时候，匹配我们的自定义约束。
当路由是 api/Test/{大于2的整数} 的时候，匹配第二个路由。
其他情况匹配第三个路由。
结论
路由约束在某些场景下是非常有用的功能，可以减少 controller 中校验参数，将部分参数校验的功能使用声明式的 attruibute 来实现，某些重复的校验可以通过抽取成约束公共使用。
constraint 的构造函数可以使用注入，所以可以扩展性十分强，可以通过查询数据库做一些参数校验。