005. Asp.Net Routing与MVC 之三： 路由在MVC的使用

上次讲到请求如何激活Controller和Action，这次讲下MVC中路由的使用。
本次两个关注点：

• 遗留：ModelBinder.BindModel的过程
• MVC中路由的使用
• MVC 5中的Action新特性

一、ModelBinder.BindModel的过程

MVCHander –>  ProcessRequest()
xxxxxController\ControllerFactory
IController.Excute();
ControllerBase.Excute().ExcuteCore()
Controller.ExecuteCore()  { . GetActionName  ;  IActionInvoker.InvokeAction() }

IActionInvoker.InvokeAction() {

get methodInfo  //sys

处理参数  // BindModel

methodInfo.invoke();//sys

}

在MVC源码中，ControllerActionInvoker.InvokeAction（）
我们看看BindModel做了些什么。

   1:  

   2: public class DefaultModelBinder : IModelBinder

   3: {

   4:     /// <summary>

   5:     /// ControllerContext (控制器上下文，包含Controller 类型实例，和 当前请求上下文RequestContext)

   6:     /// MVC Model Bind, 从  ControllerContext 中，为当前参数（确定的类型 和 名称）赋值。

   7:     /// </summary>

   8:     /// <param name="controllerContext"></param>

   9:     /// <param name="modelName"></param>

  10:     /// <param name="modelType"></param>

  11:     /// <returns></returns>

  12:     public object BindModel(ControllerContext controllerContext, string modelName, Type modelType)

  13:     {

  14:         // 值类型 或 对象值类型（string）,即简单点说：值类型

  15:         if (modelType.IsValueType || typeof(string) == modelType)

  16:         {

  17:             object instance;

  18:             //获取值类型的 值实例，并返回

  19:             if (GetValueTypeInstance(controllerContext, modelName, modelType, out instance))

  20:             {

  21:                 return instance;

  22:             };

  23:             return Activator.CreateInstance(modelType);

  24:         }

  25:  

  26:         //不是值类型，即 对象类型

  27:         //使用类型默认构造函数，创建一个实例

  28:         object modelInstance = Activator.CreateInstance(modelType);

  29:         //下边就是一个循环的过程，查找对象的属性，值类型的就赋值，循环属性直至完成

  30:         foreach (PropertyInfo property in modelType.GetProperties())

  31:         {

  32:             //忽略了 action参数 的对象类型中“对象类型”的属性

  33:             if (!property.CanWrite || (!property.PropertyType.IsValueType && property.PropertyType != typeof(string)))

  34:             {

  35:                 continue;

  36:             }

  37:             object propertyValue;

  38:             if (GetValueTypeInstance(controllerContext, property.Name, property.PropertyType, out propertyValue))

  39:             {

  40:                 property.SetValue(modelInstance, propertyValue, null);

  41:             }

  42:         }

  43:         return modelInstance;

  44:     }

  45:  

  46:     /// <summary>

  47:     /// 为值类型 或 对象值类型（string）,（即简单点说：值类型）获取值。

  48:     ///  结构体（数值，bool，自定义结构体struct），枚举enum，可空类型 

  49:     /// </summary>

  50:     /// <param name="controllerContext"></param>

  51:     /// <param name="modelName"></param>

  52:     /// <param name="modelType"></param>

  53:     /// <param name="value"></param>

  54:     /// <returns></returns>

  55:     private bool GetValueTypeInstance(ControllerContext controllerContext, string modelName, Type modelType, out object value)

  56:     {

  57:         //HttpPost 提交，使用窗体变量集合  

  58:         var form = HttpContext.Current.Request.Form;

  59:         string key;

  60:         //form集合不为空

  61:         if (null != form)

  62:         {

  63:             //窗体变量集合 AllKeys 里查找 “modelName” 变量。

  64:             key = form.AllKeys.FirstOrDefault(k => string.Compare(k, modelName, true) == 0);

  65:             if (key != null)

  66:             {

  67:                 //?结构体

  68:                 //value =  Convert.ChangeType(form[key]., modelType);

  69:                 var curKeyVal = form[key];

  70:                 value = Convert.ChangeType(curKeyVal, modelType);

  71:                 return true;

  72:             }

  73:         }

  74:         //HttpGet 提交,使用路由值中的 QueryString

  75:         key = controllerContext.RequestContext.RouteData.Values

  76:             //更快！

  77:             //.Where(item => string.Equals(item.Key, modelName,StringComparison.InvariantCultureIgnoreCase))

  78:             .Where(item => string.Compare(item.Key, modelName, true) == 0)

  79:             //get提交中，只取当前key的第一个匹配项的值

  80:             .Select(item => item.Key).FirstOrDefault();

  81:         if (null != key)

  82:         {

  83:             value = Convert.ChangeType(controllerContext.RequestContext.RouteData.Values[key], modelType);

  84:             return true;

  85:         }

  86:  

  87:         //http://msdn.microsoft.com/zh-cn/library/system.web.routing.routedata.datatokens.aspx

  88:         //RouteData.DataTokens 属性

  89:         //与RouteData.Values类似的键值对方式，允许按key获取值。

  90:         //没试出与 RouteData.Values的区别？？？

  91:         key = controllerContext.RequestContext.RouteData.DataTokens

  92:             .Where(item => string.Compare(item.Key, modelName, true) == 0)

  93:             .Select(item => item.Key).FirstOrDefault();

  94:         if (null != key)

  95:         {

  96:             value = Convert.ChangeType(controllerContext.RequestContext.RouteData.DataTokens[key], modelType);

  97:             return true;

  98:         }

  99:         value = null;

 100:         return false;

 101:     }

 102: }

 

概括的说，就是 

1、ControllerActionInvoker.InvokeAction() 里，获取当前 MethodInfo 的参数数组（在完整的MVC项目中，在InvokeAction时，还有各种过滤器的操作，ActionExecutedContext Action执行上下文的构建等）

2、循环 MethodInfo 的 参数数组，调用 IModelBinder.BindModel（）为参数赋值

3、在IModelBinder.BindModel（），判断参数的类型，是值类型的，直接从 RouteData里获取路由值，转换成对应的类型输出并返回。

4、是引用类型的，调用该类型的默认构造函数，实例化一个该类型，并循环其公开属性，重复值类型的赋值方式，赋值输出并返回。

 

 

二、MVC中路由的使用

   MVC中，用户访问的地址并不映射到服务器中对应的文件，而是映射到对应Control里对应的ActionMethod，由ActionMethod来决定返回用户什么样的信息。而把用户访问的地址对应到对应的Action(当然也可以是对应的文件)的工作有路由系统完成，这其中许多复杂的处理由.net自动完成，而开发者需要告诉.net用户的访问地址和对应Action的具体映射关系。
MVC中路由系统可以完成两件任务：
(1). 处理从用户接收到得URL映射到对应的Action；
(2). 将某个Action根据路由系统的映射关系，动态生成URL，（当网站程序结构改变时，该URL同样会自动改变）；

 

1、注册：

在MVC项目的 RouteConfig.RegisterRoutes(）里注册，一个典型的 RouteConfig内容如下：

   1: public class RouteConfig

   2: {

   3:     public static void RegisterRoutes(RouteCollection routes)

   4:     {

   5:         routes.IgnoreRoute("{resource}.axd/{*pathInfo}");

   6:  

   7:         Route myRoute1 = new Route("mytest/{controller}/{action}/{id}", new MvcRouteHandler());        

   8:         routes.Add("MyRoute1", myRoute1);

   9:  

  10:         //玄机就在这了，这个MapRoute位于System.Web.Mvc.RouteCollectionExtensions

  11:         //看RouteCollectionExtensions里面做了什么

  12:         routes.MapRoute(

  13:             name: "Default",//命名

  14:             url: "{controller11}/{action2123}/{id}",  //url 这里使用了路由规则表达式，在《Asp.Net Routing与MVC 之三： 路由在MVC的使用》里说

  15:             //id = UrlParameter.Optional  可选的路由参数

  16:             defaults: new { controller11 = "Home", action2123 = "Index", id = UrlParameter.Optional }

  17:         );

  18:     //不存在的url

  19:     routes.MapRoute(

  20:             name: "DefaultNonExist",//命名

  21:             url: "{controller11}/{action2123}/{id}",  //url 这里使用了路由规则表达式，在《Asp.Net Routing与MVC 之三： 路由在MVC的使用》里说

  22:             //id = UrlParameter.Optional  可选的路由参数

  23:             defaults: new { controller11 = "Home", action2123 = "IndexNonExist", id = UrlParameter.Optional }

  24:         );

  25:  

  26:  

  27:  

  28:         //要启用MVC5的新特性，这里需要启用“映射特性路由”

  29:         routes.MapMvcAttributeRoutes();

  30:     }

  31: }

 

2、处理接受到的URL

第二个参数中， "ABC{category}/{controller}/Page{page}/DEF"，路由系统会根据此处的参数，把用户请求的URL和这里的参数进行匹配，有两种映射匹配方式：

     (1).动态内容，放在{}里的，即为要匹配的参数名，比如controller，action中的内容均会被匹配并赋值给controller，action参数。然后依据controller，action参数的值，查找controller类型，并到此controller里需找对应的ActionMethod。

     (2).静态内容，放在{}以外的内容，会将此处每一个字符同URL进行比较，比如mytest/…这些

如果URL和该参数的两种比较方式比均均匹配成功，则为完全匹配。接下来相应的Controller和Action进行执行处理。
否则，未匹配成 功的URL项：比如action2123，会按默认的参数去匹配Action，如果默认参数匹配不成功，则抛出异常

如果相同的URL，注册了多个重复的MapRoute时，仅有第一个会生效、。

 

 

3、将对应的Action转换为URL
   路由系统的第二个功能就是实现把Action转换为对应的URL。

   1，生成链接：<a>
   @Html.ActionLink("About this application", "Index", "Home",new {id = "myAnchorID", @class = "myCSSClass"})第四个参数可以为生成的链接提供属性; 当提供的参数和路由系统中的参数不一致时，会生成QueryString：?..=..
   2，生成URL字符串：仅仅产生URL的字符串，即href后的内容
    @Html.Action(),用法同ActionLink一致。

 

 

三、MVC5中的新的路由特性

 

1、什么是Attribute路由？怎么样启用Attribute路由？

　　微软在 ASP.NET MVC5 中引入了一种新型路由：Attribute路由，顾名思义，Attribute路由是通过Attribute来定义路由。当然，MVC5也支持以前定义路由的方式，你可以在一个项目中混合使用这两种方式来定义路由。　　

在MVC5中，我们可以把路由定义和 Action 放在一起，新的方式：

   1: //MVC 5 的新路由特性，我们不用去 RouteConfig中劳神了

   2: [Route("{testId:int}/{testName}")]

   3: public ActionResult About(int testId,string testName)

   4: {

   5:     ViewBag.Message =string.Format( "Your application description page.test info :{0},{1}",testId,testName);

   6:  

   7:     return View();

   8: }

 

2、URL可选参数和默认值

　　我们可以使用问号“?”来标记一个可选参数，也可以对参数设定默认值：

   1: //可选的特性路由参数 及默认值

   2: [Route("{testId?}/{testName=JasonLiu}")]

   3: public ActionResult About1(int? testId,string testName)

   4: {

   5:     ViewBag.Message = string.Format("Your application description page.test info :{0},{1}", testId,testName);

   6:  

   7:     return View();

   8: }

3、路由前缀与默认路由

　　有时候在同一个 Controller 中，所有 Action 匹配的 URL 都拥有相同的前缀，当某个Action 不想使用该前缀时，我们用 ~来忽略她。、

并且可以指定当前路由的默认值。

   1: [RoutePrefix("myhome")] //此Controller的默认路由前缀

   2: [Route("{action=index}")] //此Controller对应路由的默认action值

   3: [Route("{testName=JasonLiu}")] //如上类推

   4: public class HomeController : Controller

   5: { 

   6:  

   7:     public ActionResult Index()

   8:     { 

   9:         return View();

  10:     }

  11:  

  12:     //MVC 5 的新路由特性，我们不用去 RouteConfig中劳神了

  13:     [Route("{testId:int}/{testName}")]

  14:     public ActionResult About(int testId,string testName)

  15:     {

  16:         ViewBag.Message =string.Format( "Your application description page.test info :{0},{1}",testId,testName);

  17:  

  18:         return View();

  19:     }

  20:  

  21:     //可选的特性路由参数 及默认值

  22:     [Route("{testId?}/{testName=JasonLiu}")]

  23:     public ActionResult About1(int? testId, string testName)

  24:     {

  25:         ViewBag.Message = string.Format("Your application description page.test info :{0},{1}", testId, testName);

  26:  

  27:         return View();

  28:     }

  29:  

  30:     [Route("~/contact")]

  31:     public ActionResult Contact()

  32:     {

  33:         ViewBag.Message = "Your contact page.";

  34:  

  35:         return View();

  36:     }

  37: }

别的，路由约束之类，与之前普通路由定义遵守相同规则。