REST並沒有像傳統的RPC服務那樣顯式指定了服務器函數的訪問路徑,而是將URL根據一定的規則映射為服務函數入口,這個規則就稱之為路由。Asp.Net WebAPI的路由方式和Asp.Net MVC是相同的,它支持兩種路由方式,傳統的路由映射和特性路由。 路由規則WebApiConfig.cs中定義,它的默認內容如下:
public static class WebApiConfig
{
public static void Register(HttpConfiguration config)
{
config.MapHttpAttributeRoutes();
config.Routes.MapHttpRoute(
name: "DefaultApi",
routeTemplate: "api/{controller}/{id}",
defaults: new { id = RouteParameter.Optional }
);
}
}
它默認注冊了兩種路由規則,第一行注冊的是特性路由,第二行注冊的則是傳統的映射路由。默認情況下,由於我們沒有編寫特性路由規則,則是按照傳統的Controller方式映射路由。
關於路由規則,MSDN文檔ASP.NET 路由介紹得非常詳細,但由於其介紹得太詳細了,反而不容易得其門而入,這里我只拿默認的路由規則來簡單但的介紹一下我的理解,它的uri格式是這樣的"api/{controller}/{id}",其中id是可選的。拿前文的例子來說吧,
-
當我們對api/products地址進行訪問的時候,系統則會首先找到名為ProductsController的控制器。
-
然后,根據訪問方式查找函數,由於這里是Get操作,則查找Get開頭的函數, 這里會找到Get()和Get(int id)兩個重載版本。
-
最后,根據參數來匹配具體的函數,因為這里沒有帶參數id。因此匹配到了Get()函數,返回了所有的集合。
另外,這里也有幾個常用的衍生規則:
-
根據操作方式找函數的時候,只需要匹配首部即可,因此我們編寫函數的時候寫成 Get() 和 GetProduct()都是可以的 。,
-
根據操作方式找函數的時候查找的時候不分大小寫,因此寫成 Get() 或g et() 都是可以的
當我們使用帶參數的版本時候,也有幾個需要注意的地方:
-
參數名不分大小寫,我們寫成id或ID都是可以的
-
參數名要求嚴格匹配的,我們寫成ID2是不行的,此時則會匹配到錯誤的結果Get()
默認的規則雖然大多數的時候還是比較方便的,但是很多時候我們需要手動指定個性化的路由規則。例如,我們可以自定義一個按名稱來查詢的url:api/products/name=xxx。這個時候則可以用特性路由快速的實現了:
[Route("api/{controller}/name={name}")]
public IHttpActionResult GetByName(string name)
關於特性路由,MSDN原文Attribute Routing in ASP.NET MVC 5介紹得非常詳細,國內也有非常不錯的譯文版本Attribute Routing in ASP.NET MVC 5 翻譯及補充,這里就不做多少介紹了。
