特性路由
WebApi2默認的路由規則我們稱作基於約定路由,很多時候我們使用RESTful風格的URI.簡單的路由是沒問題的，如 api/Products/{id}，但有些事很難處理的，如資源之間存在嵌套關係：客戶包含訂單，書有作者屬性等等。對於這種Uri，我們希望的路由是這樣的：/costomers/{customerid}/orders 或 /costomers/{customerid}/orders/{orderid}
考慮到這只是某個Controller的路由格式，而我們會有很多個Controller，用基於約定路由顯然不合適(要配置很多的路由)
使用特性路由就簡單了，在action上加一個特性即可
[Route("customers/{customerId}/orders")]public IEnumerable<Order> GetOrdersByCustomer(int customerId) { ... }
通過使用特性路由，我們還可以做API的版本控制
/api/v1/products
/api/v2/products
啓用特性路由需要在配置過程中調用System.Web.HttpConfigurationExtensions類的MapHttpAttributeRoutes方法
using System.Web.Http;namespace WebApplication
{ public static class WebApiConfig
{ public static void Register(HttpConfiguration config)
{ // Web API routes config.MapHttpAttributeRoutes(); // Other Web API configuration not shown. }
}
}
在WebApi1中 項目模板是這樣的
protected void Application_Start()
{
WebApiConfig.Register(GlobalConfiguration.Configuration); //。。。}
如果要啓用特性路由，需要改成如下代碼
protected void Application_Start()
{
GlobalConfiguration.Configure(WebApiConfig.Register); //。。。}
注：特性路由和基於約定路由是可以結合使用大的。
HttpMethod
默認情況，WebApi會根據action的方法名前綴查找action(不區分大小寫)，比如GetUsers，會匹配Get。通過在action上添加HttpMethod特性，可以覆蓋action需要映射的Http Method。
可使用的特性包括：[HttpDelete],[HttpPost],[HttpHead],[HttpOptions],[HttpPatch],[HttpGet],[HttpPut]
通過AcceptVerbs特性，我們還可以指定非標準方法以及多個方法，如 [AcceptVerbs("MKCOL","GET","POST")]
路由前綴
通常情況下，一個Controller下的action會使用相似的路由模板，如
[Route("api/books")]
[Route("api/books/{id:int}")]
[Route("api/books/{bookid}/authors")]
這時候可以爲整個controller指定[RoutePrefix]特性，以使用共同的前綴，把[RoutePrefix("/api/books")]加到controller上，action的路由特性就變成這樣：
[Route("")]
[Route("{id:int}")]
[Route("{bookid}/authors")]
此外，路由前綴中也可以包含參數，如[RoutePrefix("api/{userid}/books")]
這裏還有兩個小技巧
如果有某個特殊路由不希望使用前綴，可以在路由中添加~，如[Route("~api/otherbooks")]
有時候需要幾個路由片段結合起作用，如日期 /api/books/date/2013/06/17
這時候就需要使用字符* ,[Route("date/{*date:datetime:regex(\\d{4}/\\d{2}/\\d{2})}")],不過這種參數只能用作路由的最後一個參數
路由約束
路由約束讓我們可以限制模板參數的匹配方式。一般的語法是 "{參數：約束類型}"：
[Route("users/{id:int}"]public User GetUserById(int id) { ... }
[Route("users/{name}"]public User GetUserByName(string name) { ... }
如果參數int，則選中第一個GetUserById，否則是GetUserByName。(跟方法定義的順序無關)
下面的表格列出了支持的約束
| 約束 | 介紹 | 示例 |
|---|---|---|
| alpha | 匹配大寫或小寫字母 (a-z, A-Z) | {x:alpha} |
| bool | {x:bool} | |
| datetime | {x:datetime} | |
| decimal | {x:decimal} | |
| double | {x:double} | |
| float | 匹配一個 32位浮點數 | {x:float} |
| guid | {x:guid} | |
| int | {x:int} | |
| length | 匹配一個長度在指定範圍內的字符串 | {x:length(6)} {x:length(1,20)} |
| long | {x:long} | |
| max | 匹配指定了最大值的整數 | {x:max(10)} |
| maxlength | 匹配指定了最大長度字符串 | {x:maxlength(10)} |
| min | 匹配指定了最小值的整數 | {x:min(10)} |
| minlength | 匹配指定了最小長度字符串 | {x:minlength(10)} |
| range | 匹配指定了大小區間的整數 | {x:range(10,50)} |
| regex | 匹配一個正則表達式 | {x:regex(^\d{3}-\d{3}-\d{4}$)} |
如果要指定多個約束，需要用冒號間隔 [Route("users/{id:int:min(1)}")]
通過實現IHttpRouteConstraint接口，還可以創建自定義路由約束。（不過一般正則就可以搞定了）
還可以通過實現IInlineConstraintResolver接口替換整個DefaultInlineConstraintResolver類。這樣做將取代所有的內置的約束，除非實現IInlineConstraintResolver的類將它們添加進去。
自定義路由約束Demo
可選URI參數，默認值
通過在參數約束後面添加一個問號，可以設定URI參數是可選的；也可以像普通方法那樣指定默認值：
[Route("api/books/locale/{lcid:int?}")]public IEnumerable<Book> GetBooksByLocale(int lcid = 1033) { ... }[Route("api/books/locale/{lcid:int=1033}")]public IEnumerable<Book> GetBooksByLocale(int lcid) { ... }
這兩者是等價的
路由名稱
WebApi中，每一個路由都有一個名字，用於生成鏈接，並在放入Http響應中。（應該是用於重定向吧）
例如對某個action A指定Name，[Route("api/books/{id}", Name="GetBookById")]
那麼其他action B在需要返回這個action A的鏈接時，就可以這樣使用
public HttpResponseMessage Post(Book book)
{ var response = Request.CreateResponse(HttpStatusCode.Created); string uri = Url.Link("GetBookById", new { id = book.BookId });
response.Headers.Location = new Uri(uri); return response;
}
路由順序
通過設定特性[Route("xxx",RouteOrder=n)]可以指定路由的查找順序
[Route("pending", RouteOrder = 1)]public HttpResponseMessage GetPending() { ... }
不過意義不大，通過順序來控制，還不如設定更好的路由來的實際，而且不至於讓開發人員覺得混亂。
http://www.asp.net/web-api/overview/web-api-routing-and-actions/attribute-routing-in-web-api-2#order
翻譯：
http://www.asp.net/web-api/overview/web-api-routing-and-actions/attribute-routing-in-web-api-2
（注）：相關文檔請看https://docs.microsoft.com/en-us/aspnet/web-api/overview/web-api-routing-and-actions/attribute-routing-in-web-api-2