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

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

创新互联是一家专业提供聂拉木企业网站建设,专注与做网站、网站制作H5网站设计、小程序制作等业务。10年已为聂拉木众多企业、政府机构等服务。创新互联专业网站制作公司优惠进行中。

大家都知道我们在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中实际生效。

#p#

三、具体实现

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 Routes = new List(); 
  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
  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 HttpRoutes = new List(); 
  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(); 
  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 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的一个很小的功能拓展,小项目可能不太需要这个功能,但有时候项目大了注册的路由不生效时你应该要想到有可能是因为路由顺序的原因,这时这个路由优先级的功能有可能就会给你带来便利。总之共享给有需要的朋友们参考。

名称栏目:给ASP.NETMVC及WebApi添加路由优先级
文章转载:http://www.shufengxianlan.com/qtweb/news45/32795.html

网站建设、网络推广公司-创新互联,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等

广告

声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联