特性路由
路由的目的:对http请求提取ControllerName和ActionName,从而映射到具体Action。
特性路由:在设计时通过对Controller或Action标注映射到路由上,其实时根据Controller或Action上Attribute生成Route
并添加到RouteTable
。
特性路由注册
特性名 | 注册方式 | 例子 |
---|---|---|
RouteAttribute | 定义Action对应的路由 | [Route("movies/{id}")] |
RoutePrefixAttribute | 应用于Controller,定义前缀 | RoutePrefix("movies/") |
RouteAreaAttribute | 应用于Controller,定义于Area | RouteArea("movies") |
注意定义模板的占位符指代Action的参数,Controller
和Action
以通过反射赋值,最终生成的Route加入到RouteTable
路由约束
路由的占位符约束,内联约束的写作形式。
[Route("movies/{id:int}")]
id必须为int类型。
内部象关流程
RouteCollectionAttributeRoutingExtensions
的扩展方法完成特性路由注册
public static void MapMvcAttributeRoutes(this RouteCollection routes,IInlineConstraintResolver constraintResolver)
- 根据字符选择约束类型
IInlineConstraintResolver
,实现接口类DefaultInlineConstraintResolver
属性ConstraintMap
为约束字典,ResoveConstraint(string inlineConstraint)
方法返回约束实体 - 约束继承接口
IRouteConstraint
自定约束
自定义特性路由
- 约束实现接口
IRouteConstraint
- 注册如内联约束
public static class RouteConfig
{
public static void RegisterRoutes( RouteCollection routes)
{
DefaultInlineConstraintResolver constraintResolver = new DefaultInlineConstraintResolver();
constraintResolver. ConstraintMap. Add( "culture", typeof( CultureRouteConstraint));
routes. MapMvcAttributeRoutes( constraintResolver);
//其他 操作
}
}
路由创建过程
怎样根据特性生成路由的呢?
- 在运行
routes.MapMvcAttributeRoutes( constraintResolver);
时,会通过DependencyResolver
提取ControllerFactory
。 - 通过
ControllerFactory
得到所有的Controller
- 根据
Controller
得到ReflectedAsyncControllerDescriptor
,在得到在Controller
和Action
上的Attribute - 最后将得到的
Route
添加到RouteTable