给ASP.NET MVC及WebApi添加路由优先级

来源:互联网 发布:淘宝评价怎么取消隐藏 编辑:程序博客网 时间:2024/05/27 01:10

这是一个对Asp.Net Mvc的一个很小的功能拓展,小项目可能不太需要这个功能,但有时候项目大了注册的路由不生效时你应该要想到有可能是因为路由顺序的原因,这时这个路由优先级的功能有可能就会给你带来便利。


一、为什么需要路由优先级

大家都知道我们在Asp.Net MVC项目或WebApi项目中注册路由是没有优先级的,当项目比较大、或有多个区域、或多个Web项目、或采用插件式框架开发时,我们的路由注册很可能 不是写在一个文件中的,而是分散在很多不同项目的文件中,这样一来,路由的优先级的问题就突显出来了。

比如: App_Start/RouteConfig.cs中

  1. routes.MapRoute( 
  2.     name: "Default"
  3.     url: "{controller}/{action}/{id}"
  4.     defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional } 
  5. ); 
  6.  
  7. Areas/Admin/AdminAreaRegistration.cs中 
  8.  
  9. context.MapRoute( 
  10.     name: "Login",    
  11.     url: "login"
  12.     defaults: new { area = "Admin", controller = "Account", action = "Login", id = UrlParameter.Optional }, 
  13.     namespaces: new string[] { "Wenku.Admin.Controllers" } 
  14. ); 

假如是武汉电脑维修先注册上面那个通用的default路由,再注册这个login的路由,那么无论怎么样,都会先匹配第一个满足条件的路由,也就是第两个路由注册是无效的。
造成这个问题的原因就是这两个路由注册的顺序问题,而Asp.Net MVC及WebApi中注册路由都没有优先级这个概念,所以今天我们就是要自己实现这个想法,在注册路由时加入一个优先级的概念。

二、解决思路

1、先分析路由注册的入口,比如我们新建一个mvc4.0的项目

 
  1. public class MvcApplication : System.Web.HttpApplication 
  2.     protected void Application_Start() 
  3.     { 
  4.         AreaRegistration.RegisterAllAreas(); 
  5.  
  6.         WebApiConfig.Register(GlobalConfiguration.Configuration); 
  7.         FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters); 
  8.         RouteConfig.RegisterRoutes(RouteTable.Routes); 
  9.     } 

Mvc路由的注册入口有两个:
a. AreaRegistration.RegisterAllAreas();                            注册区域路由
b. RouteConfig.RegisterRoutes(RouteTable.Routes);          注册项目路由

WebApi路由注册入口有一个:
WebApiConfig.Register(GlobalConfiguration.Configuration);  注册WebApi路由

2、注册路由的处理类分析

AreaRegistrationContext
RouteCollection
HttpRouteCollection

注册路由时主要是由这三个类来注册处理路由的。

3、路由优先级方案

a、更改路由的注册入口
b、自定义一个路由的结构类RoutePriority及HttpRoutePriority,这两个类下面都有Priority这个属性
c、自定一个RegistrationContext来注册路由,注册的对象为上述自定义路由。
d、所有的路由注册完成之后再按优先顺序添加到RouteCollection及HttpRouteCollection中实际生效。

三、具体实现

1、路由定义

  1. public class RoutePriority : Route 
  2.     public string Name { get; set; } 
  3.     public int Priority { get; set; } 
  4.  
  5.     public RoutePriority(string url, IRouteHandler routeHandler) 
  6.         : base(url,routeHandler) 
  7.     { 
  8.  
  9.     } 
  10.  
  11. public class HttpRoutePriority 
  12.     public string Name { get; set; } 
  13.     public int Priority { get; set; } 
  14.     public string RouteTemplate{get;set;} 
  15.     public object Defaults{get;set;} 
  16.     public object Constraints{get;set;} 
  17.     public HttpMessageHandler Handler{get;set;} 

2、定义路由注册的接口

  1. public interface IRouteRegister 
  2.     void Register(RegistrationContext context); 

3、定义路由注册上下文类

  1. public class RegistrationContext 
  2.     #region mvc 
  3.     public List<RoutePriority> Routes = new List<RoutePriority>(); 
  4.  
  5.     public RoutePriority MapRoute(string name, string url,int priority=0
  6.     { 
  7.         return MapRoute(name, url, (object)null /* defaults */, priority); 
  8.     } 
  9.  
  10.     public RoutePriority MapRoute(string name, string url, object defaults, int priority = 0
  11.     { 
  12.         return MapRoute(name, url, defaults, (object)null /* constraints */, priority); 
  13.     } 
  14.  
  15.     public RoutePriority MapRoute(string name, string url, object defaults, object constraints, int priority = 0
  16.     { 
  17.         return MapRoute(name, url, defaults, constraints, null /* namespaces */, priority); 
  18.     } 
  19.  
  20.     public RoutePriority MapRoute(string name, string url, string[] namespaces, int priority = 0
  21.     { 
  22.         return MapRoute(name, url, (object)null /* defaults */, namespaces, priority); 
  23.     } 
  24.  
  25.     public RoutePriority MapRoute(string name, string url, object defaults, string[] namespaces,int priority=0
  26.     { 
  27.         return MapRoute(name, url, defaults, null /* constraints */, namespaces, priority); 
  28.     } 
  29.  
  30.     public RoutePriority MapRoute(string name, string url, object defaults, object constraints, string[] namespaces, int priority = 0
  31.     { 
  32.         var route = MapPriorityRoute(name, url, defaults, constraints, namespaces, priority); 
  33.         var areaName = GetAreaName(defaults); 
  34.         route.DataTokens["area"] = areaName; 
  35.  
  36.         // disabling the namespace lookup fallback mechanism keeps this areas from accidentally picking up 
  37.         // controllers belonging to other areas 
  38.         bool useNamespaceFallback = (namespaces == null || namespaces.Length == 0); 
  39.         route.DataTokens["UseNamespaceFallback"] = useNamespaceFallback; 
  40.  
  41.         return route; 
  42.     } 
  43.  
  44.     private static string GetAreaName(object defaults) 
  45.     { 
  46.         if (defaults != null
  47.         { 
  48.             var property = defaults.GetType().GetProperty("area"); 
  49.             if (property != null
  50.                 return (string)property.GetValue(defaults, null); 
  51.         } 
  52.  
  53.         return null
  54.     } 
  55.  
  56.     private RoutePriority MapPriorityRoute(string name, string url, object defaults, object constraints, string[] namespaces,int priority) 
  57.     { 
  58.         if (url == null
  59.         { 
  60.             throw new ArgumentNullException("url"); 
  61.         } 
  62.  
  63.         var route = new RoutePriority(url, new MvcRouteHandler()) 
  64.         { 
  65.             Name = name, 
  66.             Priority = priority, 
  67.             Defaults = CreateRouteValueDictionary(defaults), 
  68.             Constraints = CreateRouteValueDictionary(constraints), 
  69.             DataTokens = new RouteValueDictionary() 
  70.         }; 
  71.  
  72.         if ((namespaces != null) && (namespaces.Length > 0)) 
  73.         { 
  74.             route.DataTokens["Namespaces"] = namespaces; 
  75.         } 
  76.  
  77.         Routes.Add(route); 
  78.         return route; 
  79.     } 
  80.  
  81.     private static RouteValueDictionary CreateRouteValueDictionary(object values) 
  82.     { 
  83.         var dictionary = values as IDictionary<string, object>; 
  84.         if (dictionary != null
  85.         { 
  86.             return new RouteValueDictionary(dictionary); 
  87.         } 
  88.  
  89.         return new RouteValueDictionary(values); 
  90.     } 
  91.     #endregion 
  92.  
  93.     #region http 
  94.     public List<HttpRoutePriority> HttpRoutes = new List<HttpRoutePriority>(); 
  95.  
  96.     public HttpRoutePriority MapHttpRoute(string name, string routeTemplate, int priority = 0
  97.     { 
  98.         return MapHttpRoute(name, routeTemplate, defaults: null, constraints: null, handler: null, priority: priority); 
  99.     } 
  100.  
  101.     public HttpRoutePriority MapHttpRoute(string name, string routeTemplate, object defaults, int priority = 0
  102.     { 
  103.         return MapHttpRoute(name, routeTemplate, defaults, constraints: null, handler: null, priority: priority); 
  104.     } 
  105.  
  106.     public HttpRoutePriority MapHttpRoute(string name, string routeTemplate, object defaults, object constraints, int priority = 0
  107.     { 
  108.         return MapHttpRoute(name, routeTemplate, defaults, constraints, handler: null, priority: priority); 
  109.     } 
  110.  
  111.     public HttpRoutePriority MapHttpRoute(string name, string routeTemplate, object defaults, object constraints, HttpMessageHandler handler, int priority = 0
  112.     { 
  113.         var httpRoute = new HttpRoutePriority(); 
  114.         httpRoute.Name = name; 
  115.         httpRoute.RouteTemplate = routeTemplate; 
  116.         httpRoute.Defaults = defaults; 
  117.         httpRoute.Constraints = constraints; 
  118.         httpRoute.Handler = handler; 
  119.         httpRoute.Priority = priority; 
  120.         HttpRoutes.Add(httpRoute); 
  121.  
  122.         return httpRoute; 
  123.     } 
  124.     #endregion 

4、把路由注册处理方法添加到Configuration类中

  1. public static Configuration RegisterRoutePriority(this Configuration config) 
  2.     var typesSoFar = new List<Type>(); 
  3.     var assemblies = GetReferencedAssemblies(); 
  4.     foreach (Assembly assembly in assemblies) 
  5.     { 
  6.         var types = assembly.GetTypes().Where(t => typeof(IRouteRegister).IsAssignableFrom(t) && !t.IsAbstract && !t.IsInterface); 
  7.         typesSoFar.AddRange(types); 
  8.     } 
  9.  
  10.     var context = new RegistrationContext(); 
  11.     foreach (var type in typesSoFar) 
  12.     { 
  13.         var obj = (IRouteRegister)Activator.CreateInstance(type); 
  14.         obj.Register(context); 
  15.     } 
  16.  
  17.     foreach (var route in context.HttpRoutes.OrderByDescending(x => x.Priority)) 
  18.         GlobalConfiguration.Configuration.Routes.MapHttpRoute(route.Name, route.RouteTemplate, route.Defaults, route.Constraints, route.Handler); 
  19.  
  20.     foreach (var route in context.Routes.OrderByDescending(x => x.Priority)) 
  21.         RouteTable.Routes.Add(route.Name, route); 
  22.  
  23.     return config; 
  24.  
  25. private static IEnumerable<Assembly> GetReferencedAssemblies() 
  26.     var assemblies = BuildManager.GetReferencedAssemblies(); 
  27.     foreach (Assembly assembly in assemblies) 
  28.         yield return assembly; 

这样一来就大功告成,使用时只需要在Global.asax.cs文件中修改原注册入口为

  1. public class MvcApplication : System.Web.HttpApplication 
  2.     protected void Application_Start() 
  3.     { 
  4.         WebApiConfig.Register(GlobalConfiguration.Configuration); 
  5.         FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters); 
  6.         RouteConfig.RegisterRoutes(RouteTable.Routes); 
  7.  
  8.         Configuration.Instance() 
  9.             .RegisterComponents() 
  10.             .RegisterRoutePriority(); //注册自定义路由 
  11.     } 

在每个项目中使用只需要要继承自定义路由注册接口IRouteRegister,例如:

  1. public class Registration : IRouteRegister 
  2.     public void Register(RegistrationContext context) 
  3.     { 
  4.        //注册后端管理登录路由 
  5.         context.MapRoute( 
  6.           name: "Admin_Login"
  7.           url: "Admin/login"
  8.           defaults: new { area = "Admin", controller = "Account", action = "Login", id = UrlParameter.Optional }, 
  9.           namespaces: new string[] { "Wenku.Admin.Controllers" }, 
  10.           priority: 11 
  11.       ); 
  12.  
  13.        //注册后端管理页面默认路由 
  14.         context.MapRoute( 
  15.             name: "Admin_default"
  16.             url: "Admin/{controller}/{action}/{id}"
  17.             defaults: new { area = "Admin", controller = "Home", action = "Index", id = UrlParameter.Optional }, 
  18.             namespaces: new string[] { "Wenku.Admin.Controllers" }, 
  19.             priority: 10 
  20.         ); 
  21.  
  22.        //注册手机访问WebApi路由 
  23.         context.MapHttpRoute( 
  24.             name: "Mobile_Api"
  25.             routeTemplate: "api/mobile/{controller}/{action}/{id}"
  26.             defaults: new 
  27.             { 
  28.                 area = "mobile"
  29.                 action = RouteParameter.Optional, 
  30.                 id = RouteParameter.Optional, 
  31.                 namespaceName = new string[] { "Wenku.Mobile.Http" } 
  32.             }, 
  33.             constraints: new { action = new StartWithConstraint() }, 
  34.             priority: 0 
  35.         ); 
  36.     } 

四、总结

这是一个对Asp.Net Mvc的一个很小的功能拓展,小项目可能不太需要这个功能,但有时候项目大了注册的路由不生效时你应该要想到有可能是因为路由顺序的原因,这时这个路由优先级的功能有可能就会给你带来便利。总之共享给有需要的朋友们参考。


0 0
原创粉丝点击
热门问题 老师的惩罚 人脸识别 我在镇武司摸鱼那些年 重生之率土为王 我在大康的咸鱼生活 盘龙之生命进化 天生仙种 凡人之先天五行 春回大明朝 姑娘不必设防,我是瞎子 微信版本过低怎么办 报关时通关单号没录怎么办 公司注销了行政许可证怎么办呢 报关项数超过50项怎么办 出口报关件数报多了怎么办 关税少交被海关缉私查到怎么办 外贸报关hs编码报错怎么办 报关金额少报了怎么办 进口报关金额少报了怎么办 报关重量报少了怎么办 金额报多100倍怎么办 ems没扫描到单号怎么办 回国海关被税了怎么办 代购买错东西了怎么办 征信报告有逾期怎么办 evus信息填错了怎么办 清关一个月了该怎么办 清关一直不发怎么办 清关一个月了怎么办 香港ems到西安海关税怎么办 寄东西被海关扣留怎么办 天津港新舱单品名错误核销怎么办 移动手机不能用联通卡怎么办 移动手机联通卡网速卡怎么办 移动手机不支持联通4g怎么办 汽车分离轴承异响怎么办 至尊宝被冻结了怎么办 qq冻结了至尊宝怎么办 至尊宝没办法申诉怎么办 至尊宝qq被冻结怎么办 未满16岁怎么办手机卡 联想预装的office卸载怎么办 win10激活后无法启动怎么办 移动电话卡没用了没注销怎么办 快捷快递客服热线一直打不通怎么办 牛奶乳加钙咀嚼片吃多了怎么办 三生骗了我该怎么办 国珍产品新时代卡怎么办 三个月大的宝宝对眼怎么办 9月大婴儿眼睛对眼怎么办 30岁眼部有皱纹怎么办