快速入門系列--WebAPI--03框架你值得擁有
接下來進入的是俺在ASP.NET學習中最重要的WebAPI部分，在現在流行的互聯網場景下，WebAPI可以和HTML5、單頁應用程序SPA等技術和理念很好的結合在一起。所謂ASP.NET WebAPI，其核心概念就是構建REST風格的Web服務，把一起數據視為資源，無論是服務請求或者是數據操作，與以前的SOAP和XML-RPC架構風格有很大不同。說道這，很多讀者可能想到WCF中不是早都有了REST風格的服務麽，為什麽還需要這個WebAPI？確實如此，不過WCF中的該類型服務顯得比較復雜，因為其通信管道的構成由於集成了多種不同的通信協議，自然的其基礎程序集就顯得非常的龐大臃腫。
簡單來說，WebAPI就是簡單高效，"你值得擁有"！讓我們通過臨摹蔣老師的例子對它有個初步的了解，後端代碼如下：
View Code
前端代碼如下：
View Code
這個像補充的是，蔣老師在這用的是自帶的knockoutJS作為MVVM風格的部分前端框架。關於這一塊，有一個問題困擾了我很久，就是KnockoutJS和AngularJS誰的適用性更強，其實它們沒有可比性，KnockoutJS只提供了部分的工作。以下鏈接是對此問題的解釋，結論是我將學習並使用AngularJS。
http://blog.darkthread.net/post-2014-06-07-go-to-angularjs.aspx
說到這，我還想到了學習中的一個困惑，那麽多的IOC框架到底哪個相對更好一些？結論是Autofac，它以被使用在Orchard
http://www.cnblogs.com/liping13599168/archive/2011/07/17/2108734.html
接下來，介紹ASP.NET WebAPI的服務器管道，這一塊和之前學習的ASP.NET MVC管道很相似，但也有一些差異，不過個人感覺這個管道更加的像J2EE的管道了。由於很多內容比較相似，將進行簡單的介紹，不過框架中異步編程模型用的很多，值得學習參考。下圖簡單的表述了框架對請求的處理過程：
框架通過單例提供HttpControllerHandler對象，多個HttpWebRoute共享對象，並且它將創建右側的ASP.NET Web API處理管道，通過調用BeginProcessRequest方法激活管道運轉。該管道其實就是HttpMessgaeHandler鏈，HttpServer和HttpControllerDispatcher可以看做兩個特殊的HttpMessageHandler，接下來通過表格的形式對相關類型進行簡單的介紹:
| 類型 | 簡介 |
| HttpMessageHandler | 核心類，針對請求的處理實現在SendAsync中，針對響應的處理通過返回類型Task<HttpResponseMessage>完成 |
| HttpRequestMessage | Content屬性封裝Http主體信息 |
| HttpResponseMessage | StatusCode、ReasonPhrase屬性表示響應狀態碼與描述 |
| DelegatingHandler | 用於構建處理鏈，通過InnerHanlder屬性進行傳遞，是責任鏈模式的實現？ |
| HttpServer | Dispatcher屬性指向最終的分發器對象，Configuration屬性包含了所有的配置信息。 |
| HttpConfiguration | DependencyResolverFilters: AuthorizationFilter, ActionFilter, ExceptionFilterFormatters:返回格式化器列表IncludeErrorDetailPolicy:客戶端異常顯示策略PropertiesServices: 返回ServiceContainer，一個簡易IocR容器，默認實現為DefaultServices，很常用。 |
HttpControllerHandler以延遲加載的方式來創建HttpServer，字典屬性Properties以Key為"MS_HttpContext"、"MS_HttpRouteData"的形式傳遞相關數據。HttpControllerDispatcher負責最後對請求做最後的處理，包括對ApiController的激活和目標Action的執行等操作，用下表簡述該過程：
| 行為 | 簡介 |
| HttpController的激活 | 借助HttpControllerDescriptor，完成HttpController類型解析、選擇、創建等操作，可以通過自定義DependencyResolver或HttpControllerActivator來實現基於IOC的HttpController的激活。 |
| HttpController的執行 | 通過ExecuteAsync方法，參數為HttpControllerContext，註意UrlHelper中Link代表絕對地址，Route相對地址 |
| Action的選擇 | HttpActionDescriptor的ExecuteAsync方法實現Action的執行，Action支持7中不同的HTTP方法，默認為POST。通過HttpActionSelector組件實現對目標Action的選擇，方法GetActionMapping的返回值為一個ILookup<string, HttpActionDescriptor>類型 |
| Model元數據的解析 | 與MVC基本一致 |
| Action參數綁定 | 借助HttpParameterDescriptor、HttpActionBinding，通過HttpParameterBinding對象的ExecuteBindingAsync完成綁定，具體的實現類有: CancellationTokenParameterBinding ErrorParameterBinding FomatterParameterBinding：消息主體,html,json,xml HttpRequestParameterBinding：HttpRequestMessage ModelBinderParameterBinding：查詢字符串，路由數據 |
| Model的驗證 | 包括DataAnnotationModelValidator RequiredMemberModelValidator ValidatableObjectAdapter ErrorModelValidator等驗證器，需要註意的是該框架中驗證過程是遞歸的，與MVC有點不同。 |
| Action的執行與結果的響應 | 通過HttpActionInvoker的InvokerActionAsync方法激活Action，通過ActionResultConverter將Action的返回值轉換為HttpResponseMessage，轉換器包括： ResponseMessageResultConverter ValueResultConverter<T> VoidResultConverter 3個內置Filter篩選器的作用與MVC中的類似 |
補上IOC實現的代碼和HttpParameterBinding的流程圖：
View Code
HttpParameterBinding流程圖：
最後介紹與WebAPI客戶端調用相關的內容，提到調用大家第一反應就是在Web頁面中通過javascript進行Ajax調用，獲取數據並呈現，服務的消費者是前端頁面，這只是調用的主要方式之一。另外一種就是通過HttpClient來進行調用，這和Web Service調用很相似，服務的消費者是一般應用程序。HttpClient類繼承之抽象類HttpMessageInvoker，核心方法SendAsync包括HttpRequestMessage的參數和HttpResponseMessage的返回類型，和之前服務器端的HttpMessageHandler類型一樣，實際上HttpClient就是一個該類的封裝。HttpCompletionOption用於設置響應完成的標誌，包括讀完消息頭和讀完消息體。屬性BaseAddress用於指定WebAPI基地址，DefaultRequestHeader用於添加任意的報頭，MaxResponseContentBufferSize表示讀取緩存區的大小，默認2G，Timeout表示超時時限，默認100s。GetAsync, GetByteArrayAsync, GetStreamAsync, GetStringAsync用於HTTP-GET請求，其他方法也有相似定義。下面通過一個服務器端自我寄宿，客戶端一般調用的例子完成學習，需要註意通過Nuget添加SelfHost和Client的庫，代碼如下所示：
View Code
此外，WebAPI學習系列目錄如下，歡迎您的閱讀！
快速入門系列--WebAPI--01基礎
快速入門系列--WebAPI--02進階
快速入門系列--WebAPI--03框架你值得擁有
快速入門系列--WebAPI--04在老版本MVC4下的調整
註：本文主要供自己學習，不妥之處望見諒。
參考資料：
[1]蔣金楠. ASP.NET MVC4框架揭秘[M]. 上海:電子工業出版社, 2012. 445-526
快速入門系列--WebAPI--03框架你值得擁有