.net web api 的route理解

.NET web api 的特性是和MVC一样，通过Route 来控制action的访问方式。Route匹配规则是个奇特的方式，首先看一段Route的模板

Routes.MapHttpRoute(

name:"DefaultApi",

routeTemplate:"api/{orgid}/{controller}/{id}",

defaults:new {id=RouteParameter.Optional},

constants:new {orgid=@"\d+"} // 这里是给orgid的约束，必须是数字

)

现在我们在定义个Employeecontroller.cs， 在这个controller里面定义两个方法

public void  Get(int orgid , int id){}

public void Get(String orgid, int id){}

我们通过浏览器来访问这个两个action，你会发现浏览器返回有多个action在的exception，

Multiple actions were found that match the request:
RouteBookDemo.Models.Employee Get(Int32, Int32) on type RouteBookDemo.Controllers.EmployeesController
RouteBookDemo.Models.Employee Get(System.String, Int32) on type RouteBookDemo.Controllers.EmployeesController

不知道访问哪一个action， 这说明一个问题，就是我们定义好route的匹配规则时，给其中的一个占位符约束好数据类型后，不管action里面的参数定义的是什么数据类型，都会匹配到。为了验证说明是正确的，我们debug一下看看orgid的类型。

这幅图片说明，当orgid的值是113的时候，匹配到controller里面的action 的时候int 类型的113，没有异议，我们再看第二幅图

这幅图的orgid的值还是113， 但是传递到action的时候，却变成了string的"113"，现象已经很明显了，这里的占位符的数据类型最后是按照action去改变的，但是这个只是基本数据类型，换成我们自定义的数据类型会是什么样的呢？再看一副截图

这次返回了一个multiple actions 的exception，这次匹配的是get（employee，id）和get（id）的两个actions，奇怪的事情又发生了，为什么framework这次匹配到了2个actions 呢？同时也说明了，如果没有get（id）这个action，这个url也可能会匹配到get（employee，id）这个action，我们看看这里employee的传递的是什么值，看截图

这个时候113并没有发送到server端，此时的orgid的参数变成了null。

再看下面的一幅图，我们用get（int orgid，int id）和get（id）去debug，又有什么情况发生了？

此时framework匹配到了有orgid的action。

我们再看看route template里面的最后一个{Id}，我们观察到所有的action里面，如果是按照Id去get的话，都是参数名称必须是ID，我们设想一下，如果我们想按照Id是get，但是吧id换成ff，会有什么情况呢？

URL 是http://localhost:2643/api/1/employees/12345

你会发现，没有走get（orgid，ff）的方法，虽然那个ff是int型的

现在我们来总结一下上面的图和现象：

1.在route的时候，首先是按照所有的参数去匹配，不管这个参数的是什么类型的。（基本数据类型，int，string 等，自定义的类，会是null，看上面的截图）

2.在action里面的参数，必须和route template里面的占位符是一样的，id就是id，在action里面换成其他的，url就匹配不到了

3.URL 里面的参数会在action里面发生数据类型的转换