Area--->AreaRegistrationContext.MapRoute
文章引导
Area--->AreaRegister.RegisterAllArea()与Area区域的解析
引言:
学习本文建议先看下另一篇文章(Area--->AreaRegister.RegisterAllArea()与Area区域的解析),此篇文章着重解析AreaRegistrationContext.MapRoute函数。
一.先从MapRoute说起
接着上一篇文章的末尾进行阐述,上一篇文章的末尾为:
Area的注册过程的第一步先找到所有继承或实现AreaRegistration类的类并序列化之后保存进缓存文件。接着才是重头戏(MapRoute)进行路由注册。
在AreaRegistrationContext中同样存在同名的MapRoute函数。
1 public Route MapRoute(string name, string url, string[] namespaces) 2 { 3 return this.MapRoute(name, url, null, namespaces); 4 } 5 6 public Route MapRoute(string name, string url, object defaults, object constraints) 7 { 8 return this.MapRoute(name, url, defaults, constraints, null); 9 } 10 11 public Route MapRoute(string name, string url, object defaults, string[] namespaces) 12 { 13 return this.MapRoute(name, url, defaults, null, namespaces); 14 } 15 16 public Route MapRoute(string name, string url, object defaults, object constraints, string[] namespaces) 17 { 18 if ((namespaces == null) && (this.Namespaces != null)) 19 { 20 namespaces = this.Namespaces.ToArray<string>(); 21 } 22 Route route1 = this.Routes.MapRoute(name, url, defaults, constraints, namespaces); 23 route1.DataTokens["area"] = this.AreaName; 24 bool flag = (namespaces == null) || (namespaces.Length == 0); 25 route1.DataTokens["UseNamespaceFallback"] = flag; 26 return route1; 27 }
在上部代码中可以看到,整个代码的核心最终还是引用的Routes.MapRoute进行路由的注册。
二.Routes.MapRoute
Routes就是一个RouteCollection,此处的Routes还需要追溯到上一篇文章
下面为AreaRegistrationContext的构造函数,通过构造函数完成This.Routes的初始化赋值。
1 public AreaRegistrationContext(string areaName, RouteCollection routes, object state) 2 { 3 this._namespaces = new HashSet<string>(StringComparer.OrdinalIgnoreCase); 4 if (string.IsNullOrEmpty(areaName)) 5 { 6 throw System.Web.Mvc.Error.ParameterCannotBeNullOrEmpty("areaName"); 7 } 8 if (routes == null) 9 { 10 throw new ArgumentNullException("routes"); 11 } 12 this.AreaName = areaName; 13 this.Routes = routes; 14 this.State = state; 15 }
我们接着来看Routes.MapRoute的代码
上面代码实例化一个Route并对属性进行赋值,其中Constraints和DataTokens值都一样,都是new RouteValueDictionary()。由于route.Constraints为空,则ConstraintValidation.Validate(route)不会运行函数内部代码。此扩展函数最后将信息Add进当前Routes,并返回路由信息route。
最后对Routes.DataTokens(RouteValueDictionary)添加信息,并返回Route。
三.总结
针对某个Area的路由映射是通过相应的AreaRegistration进行注册的,具体来说是在AreaRegistration的RegisterArea方法中调用AreaRegistrationContext对象的MapRoute方法进行注册的。如果在调用MapRoute方法中指定了表示命名空间的字符串,将自动作为注册的路由对象的命名空间,否则会将表示AreaRegistration所在命名空间的字符串加上"."后缀作为路由对象的命名空间。
这里说的路由对象的命名空间指的是通过Route对象的DataTokens属性表示的RouteValueDictionary对象中Key为Namespaces的字符串数组,而该字符串最终会转移到生成的RouteData的DataTokens中。
除此之外,在调用AareaRegistrationContext的MapRoute方法时,还会在注册Route对象DataTokens中添加一个Key为UseNamespaceFallback的条目表示是否采用后背命名空间 对Controller进行解析。如果注册对象具有命名控件(调用MapRoute方法时指定了命名空间或对应的AreaRegistration类型定义在某个命名空间中),该条目值为false。
在解析Controller类型过程中,会先通过RouteData包含的命名空间来解析Controller类型。如果Controller类型解析失败,则通过包含RouteData的DataTokens属性key为useNamespaceFallback值来判断是否使用后背命名空间来进行解析。如果为true,则通过当前ControllerBuilder的命名空间解析,如果失败则忽略命名空间直接采用类型名称进行匹配,否则直接抛出异常。