集中式路由
问题
怎样集中的定义路由
解决方案
通过调用 HttpRouteCollectionExtension 类中的 MapHttpRoute 扩展方法在 HttpRouteCollection 中定义路由，可以通过 HttpConfiguration 对象调用。
最基础的使用就是定义一个非常通用的路由模板，他会通过 {controller} 占位符匹配所有的 Controller。如代码片段 3-1 所示。
代码片段 3-1. ASP.NET WEB API 默认定义的路由以及一个简单的 Controller
1 config.Routes.MapHttpRoute(
2 name: "DefaultApi",
3 routeTemplate: "api/{controller}/{id}",
4 defaults: new {id = RouteParameter.Optional}
5 );
6
7
8
9 public class OrdersController : ApiController
10 {
11 public Order Get(int id)
12 {
13 // 忽略逻辑
14 }
15 }
在路由模板中，可以定义自己的占位符，如代码片段 3-1 所示的 {id}。他与 Action 中的参数名称相匹配匹配，ASP.NET WEB API 会从 request 中提取出相应的值，传入 Action 方法中。也就是，代码片段 3-1 中 OrdersController 的 Get请求方法的这种情
况。
工作原理
从最初版本开始，ASP.NET WEB API 就一直使用集中式路由维护路由表，这和 MVC 如出一辙。
ASP.NET WEB API 定义了很多 MapHttpRoute 的变种。所需参数最少的一个方法，只需要一个路由模板和一个路由名称。
1 public static IHttpRoute MapHttpRoute(this HttpRouteCollection routes, string name, 2 string routeTemplate)
除声明简单基础路由以外的方式，也可以通过默认值和约束，或者设置每个路由消息处理程序，将会在下面的章节介绍这个。所有的这些操作都是通过 Map HttpRoute 的重载方法实现的。
1 public static IHttpRoute MapHttpRoute(this HttpRouteCollection routes, string name, 2 string routeTemplate, object defaults) 3 4 public static IHttpRoute MapHttpRoute(this HttpRouteCollection routes, string name, 5 string routeTemplate, object defaults, object constraints) 6 7 public static IHttpRoute MapHttpRoute(this HttpRouteCollection routes, string name, 8 string routeTemplate, object defaults, object constraints, HttpMessageHandler handler)
通过路由默认值，可以直接定位到路由相关的 Controller；可是，这样的特定路由需要定义在通用路由之前，也就是代码片段 3-1 的路由之前。原因就是，路由是顺序匹配的，路由在选定处理一个 HTTP 请求的时候，是在每次请求的时候，扫描路由集合中的所有路由，选用第一个被匹配的路由模板。简单的说，越是特殊的路由定义越靠前，越是通用的路由定义越靠后。
在 Self-hosting 中，ASP.NET WEB API 是以 IDictionary<stirng, IHttpRoute> 的形式在维护路由，Idictionary<string, IHttpRoute> 是在 HttpRouteCollection 类中。在 Web host 中也提供了 System.Web.Routing.RouteCollection 的扩展方法，因此，可以直接在这个里面定义 ASP.NET WEB API 路由。
RouteTable.Routes.MapHttpRoute("DefaultApi", "api/{controller}")
如果使用 ASP.NET 运行时 host WEB API，无论使用什么扩展方法声明路由，都会被添加到同一个 RouteTable 中。内部是通过一个叫做 HostedHttpRouteCollection 的类来实现的，这个类是 HttpRouteCollection 的子类，而不是在字典（比如 self-host）中维护路由，所有转发路由都是查找 System.Web.RouteCollection。
ASP.NET WEB API 与 ASP.NET MVC 是不一样的，API 使用的是基于 HTTP 谓词匹配来处理一个 Controller 请求。换句话说，框架会根据 HTTP 的东西来选择一个 Action 处理请求，选择的逻辑如下：
- 通过方法名推断 HTTP 谓词，如果名字类似于 PostOrder、GetById 等等。
- 通过 Action 属性推断 HTTP 谓词。
- Action 参数定义与路由模板必须匹配。
典型的 ASP.NET WEB API 路由是指向资源的。可以通过 HTTP 谓词调用，还需要除了 Action 之外的参数。如代码片段 3-1 所示的默认路由，可以匹配如下请求：
- GET myapi.com/api/orders
- POST myapi.com/api/inovice
- PUT myapi.com/api/invice/2
小提示 在 ASP.NET WEB API 是可以使用 RPC 的，具体细节会在 3-6 介绍。
代码演示
ASP.NET WEB API 是基于 HTTP 谓词进行分发逻辑的，不像 ASP.NET MVC，很容易出现 AmbiguousMatchEception。例如，可以设想一些使用代码片段 3-1 的路由的例子。
如代码片段 3-2 所示的例子，这三个方法都是可以处理相同的 GET 请求，如，/api/orders/1.
代码片段 3-2.
代码片段 3-2. ASP.NET WEB API Controller
1 public class BadOrdersController : ApiController
2 {
3 [HttpGet]
4 public Order FindById(int id)
5 {
6 // 忽略逻辑
7 }
8
9 public Order GetById(int id)
10 {
11 // 忽略逻辑
12 }
13
14 public Order Get(int id)
15 {
16 // 忽略逻辑
17 }
18 }
同时我们需要注意，定义复杂、多等级、嵌套路由的时候，集中式路由变得有点麻烦。考虑如下路由
- GET myapi.com/api/teams
- GET myapi.com/api/teams/1
- GET myapi.com/api/teams/1/players
使用集中式路由，可以在 Controller 中使用如下三个方法；然而，我们必须注意路由之间冲突的问题，因为有两个 GET 方法都是只使用了一个 int 的参数。如代码片段 3-3 所示。有一个特殊的路由指出了 URI 中包含 /players/ 段会被匹配到，而且这个路由定义在通用路由之前。
代码片段 3-3 使用集中式路由配置嵌套路由
1 public class TeamsController : ApiController
2 {
3 public Team GetTeam(int id)
4 {
5 // 忽略逻辑
6 }
7 public IEnumerable<Team> GetTeams()
8 {
9 // 忽略逻辑
10 }
11 public IEnumerable<Player> GetPlayers(int teamId)
12 {
13 // 忽略逻辑
14 }
15 }
16
17
18
19 config.Routes.MapHttpRoute(
20 name: "players",
21 routeTemplate: "api/teams/{teamid}/players",
22 defaults: new {controller = "teams"}
23 );
24 config.Routes.MapHttpRoute(
25 name: "DefaultApi",
26 routeTemplate: "api/{controller}/{id}",
27 defaults: new { id = RouteParameter.Optional }
28 );
集中式路由的主要问题是，特殊路由的定义，仅仅是处理特殊的 Controller 特殊的 Action。通过定义特殊路由并添加到一般路由之前，在人为干预下短路了路由匹配。
这种处理并不是最理想，当应用程序变大之后，会有更复杂的、多层级的路由，可能就要在集中式路由中痛苦的挣扎（路由维护和调试）。更好的选择就是使用直接式路由，下一篇 3-2 定义直接路由，以及后面介绍路由的时候都会涉及直接式路由。