第1 章 概述
1.1 何為Web..
1.1.1 TCP/IP 與HTTP
1.1.2 Web 資源..
1.1.3 HTTP 事務..
1.1.4 HTTP 報文..
1.2 RESTful Web API.
1.2.1 為什麼叫這個奇怪的名字
1.2.2 RESTful Web API 具有怎樣的特征..
1.3 初識ASP.NET Web API.
1.3.1 構建解決方案..
1.3.2 定義Web API
1.3.3 以Web Host 方式寄宿Web API
1.3.4 以Self Host 方式寄宿Web API..
1.3.5 利用HttpClient 調用Web API ..
1.3.6 創建一個"聯繫人管理器"應用.
第2 章 路由.
2.1 ASP.NET 路由.
2.1.1 請求URL 與物理文件的分離..
2.1.2 實例演示：通過URL 路由實現請求地址與Web 頁面的映射..
2.1.3 ASP.NET 路由繫統.
2.1.4 注冊路由映射
2.1.5 根據路由規則生成URL
2.1.6 HttpHandler 的動態映射.
2.2 ASP.NET Web API 路由
2.2.1 請求與響應
2.2.2 ASP.NET Web API 路由繫統
2.2.3 注冊路由映射..
2.3 兩個路由繫統的銜接.
2.3.1 HostedHttpRoute 與HostedHttpRouteCollection
2.3.2 HttpControllerRouteHandler 與HttpControllerHandler .
第3 章 消息處理管道.
3.1 HttpMessageHandler 管道
3.1.1 HttpMessageHandler
3.1.2 DelegatingHandler ..
3.1.3 HttpServer ..
3.1.4 HttpRoutingDispatcher.
3.2 Web Host 模式下的消息處理管道
3.2.1 HttpControllerHandler .
3.2.2 實例演示：自定義HttpMessageHandler 實現HTTP 方法重寫（S305） .
3.3 Self Host 模式下的消息處理管道..
3.3.1 HttpBinding
3.3.2 HttpSelfHostServer..
第4 章 HttpController 的激活.
4.1 HttpController.
4.1.1 HttpControllerContext.
4.1.2 HttpControllerDescriptor .
4.1.3 ApiController..
4.2 HttpController 是如何被創建的.
4.2.1 程序集的解析.
4.2.2 HttpController 類型的解析
4.2.3 HttpController 的選擇.
4.2.4 HttpController 的創建..
4.2.5 HttpController 的激活與釋放
4.3 IoC 的應用..
4.3.1 利用Unity 來認識IoC..
4.3.2 基於IoC 的HttpControllerActivator..
4.3.3 基於IoC 的DependencyResolver.
第5 章 Action 的選擇
5.1 HttpActionDescriptor
5.1.1 ReflectedHttpActionDescriptor
5.1.2 ActionNameAttribute .
5.1.3 方法名決定HTTP 方法..
5.1.4 ActionHttpMethodProvider
5.1.5 針對特性的緩存
5.2 HttpParameterDescriptor..
5.2.1 ReflectedHttpParameterDescriptor..
5.2.2 實例演示：解析Action 方法參數描述信息.
5.3 HttpActionSelector
5.3.1 ApiControllerActionSelector..
5.3.2 有效的Action 方法.
5.3.3 目標Action 方法的選擇
第6 章 特性路由.
6.1 特性路由注冊..
6.1.1 HttpRouteInfoProvider 特性..
6.1.2 基本路由映射.
6.1.3 讓URL 模板能夠盡可能反映資源的層次結構..
6.1.4 為路由變量設置約束.
6.1.5 通配符路由變量..
6.1.6 缺省路由變量..
6.1.7 設置URI 前綴
6.2 約束表達式的解析.
6.2.1 RangeRouteConstraint ..
6.2.2 InlineConstraintResolver .
6.2.3 自定義約束.
6.3 路由解析
6.3.1 RouteCollectionRoute .
6.3.2 實例演示：查看特性路由注冊生成的RouteCollectionRoute 對像..
6.3.3 子路由對像的創建.
6.3.4 HttpRouteData 的生成..
第7 章 Model 綁定（上篇） .
7.1 Model 綁定解決怎樣的問題.
7.1.1 基於HttpRouteData 的參數綁定.
7.1.2 基於查詢字符串的參數綁定..
7.2 Mod數據的解析..
7.2.1 Mod數據的層次化結構..
7.2.2 ModelMetadata
7.2.3 ModelMetadataProvider
7.3 ValueProvider
7.3.1 ValueProviderResult .
7.3.2 NameValuePairsValueProvider .
7.3.3 RouteDataValueProvider 與QueryStringValueProvider
7.3.4 CompositeValueProvider ..
7.4 ValueProviderFactory
7.4.1 RouteDataValueProviderFactory 與QueryStringValueProviderFactory..
7.4.2 CompositeValueProviderFactory..
7.4.3 ValueProviderFactory 的注冊..
7.4.4 自定義ValueProviderFactory..
第8 章 Model 綁定（下篇） .
8.1 ModelBinder .
8.1.1 ModelBindingContext.
8.1.2 去除前綴後的二次綁定..
8.1.3 CompositeModelBinder
8.2 ModelBinderProvider.
8.2.1 CompositeModelBinderProvider.
8.2.2 ModelBinderAttribute ..
8.2.3 Model 綁定的流程.
8.3 針對不同目標類型的Model 綁定..
8.3.1 簡單類型..
8.3.2 復雜類型.
8.3.3 集合.
8.3.4 數組.
8.3.5 字典.
8.3.6 最後一個ModelBinder ..
8.4 ModelState
8.4.1 ApiController 的ModelState
8.4.2 實例演示：獲取Model 綁定過程中由ValueProvider 提供的數據（S808）.
第9 章 參數的綁定
9.1 參數綁定繫統全景展示
9.1.1 HttpParameterBinding.
9.1.2 ActionValueBinder.
9.2 5 個原生的HttpParameterBinding
9.2.1 ModelBinderParameterBinding
9.2.2 FormatterParameterBinding .
9.2.3 HttpRequestParameterBinding
9.2.4 CancellationTokenParameterBinding .
9.2.5 ErrorParameterBinding ..
9.3 HttpParameterBinding 的創建策略..
9.3.1 ParameterBindingAttribute 特性..
9.3.2 注冊參數綁定規則
9.3.3 HttpParameterBinding 的創建策略.
第10 章 參數的驗證..
10.1 幾種參數驗證方式..
10.1.1 手工驗證綁定的參數
10.1.2 使用ValidationAttribute 特性
10.1.3 創建自我驗證數據類型
10.2 以ModelValidator 為核心的參數驗證繫統.
10.2.1 DataAnnotationsModelValidator ..
10.2.2 RequiredMemberModelValidator..
10.2.3 ValidatableObjectAdapter.
10.2.4 ErrorModelValidator
10.3 基於數據注解特性的參數驗證..
10.3.1 ValidationAttribute 特性..
10.3.2 DataAnnotationsModelValidator .
10.3.3 DataAnnotationsModelValidatorProvider
10.4 參數驗證流程
10.4.1 ModelValidationNode .
10.4.2 "驗證樹"是如何被建立起來的..
10.4.3 "必需"數據成員的驗證
10.4.4 BodyModelValidator
第11 章 Action 的執行
11.1 Action 方法的執行
11.1.1 HttpActionInvoker ..
11.1.2 ActionExecutor
11.2 內容協商
11.2.1 ContentNegotiator.
11.2.2 MediaTypeFormatter 是如何被篩選出來的..
11.2.3 如何確定響應字符集..
11.3 HttpActionResult ..
11.3.1 無響應主體的HttpActionResult ..
11.3.2 含響應主體的HttpActionResult
11.3.3 ResponseMessageResult .
11.4 HttpResponseMessage 的生成..
11.4.1 ActionResultConverter..
11.4.2 從消息處理管道來看HttpResponseMessage 的生成.
第12 章 過濾器
12.1 Filter 及其提供機制..
12.1.1 Filter..
12.1.2 FilterProvider
12.1.3 5 種Filter 類型
12.2 認證與授權
12.2.1 Identity.
12.2.2 Principal .
12.2.3 AuthenticationFilter.
12.2.4 AuthorizationFilter
12.3 針對Action 方法執行前後的攔截..
12.3.1 ActionFilterAttribute.
12.3.2 實例演示：利用自定義ActionFilter 實現對Action 方法執行結果
的緩存..
12.4 異常處理與Filter 的屏蔽..
12.4.1 ExceptionFilter
12.4.2 實例演示：利用自定義的ExceptionFilter 集成EntLib 進行異常
處理（S1208）
12.4.3 OverrideFilter .
第13 章 安全
13.1 IIS/ASP.NET 認證..
13.1.1 Basic 認證.
13.1.2 Digest 認證
13.1.3 集成Windows 認證.
13.1.4 Forms 認證..
13.2 SSL/TLS
13.2.1 非對稱加密
13.2.2 通過SSL/TLS 實現傳輸安全
13.2.3 SSL/TLS 的應用
13.3 第三方認證..
13.3.1 OAuth 2.0 簡介
13.3.2 Implicit Authorization Grant
13.3.3 Authorization Code Authorization Grant ..
第14 章 跨域資源共享..
14.1 同源策略..
14.1.1 實例演示：跨域調用Web API..
14.1.2 JSONP
14.2 CORS 規範.
14.2.1 資源的授權
14.2.2 實例演示：利用自定義的MessageHandler 支持跨域資源共享
14.3 CORS 在ASP.NET Web API 中的實現.
14.3.1 實例演示：采用ASP.NET Web API 原生的機制實現跨域資源
共享（S1406）
14.3.2 CORS 授權策略及其提供機制.
14.3.3 資源授權的檢驗和CORS 響應報頭的生成.
14.3.4 CorsMessageHandler
第15 章 Web API 的調用..
15.1 HttpClient ..
15.1.1 HttpMessageInvoker
15.1.2 HttpClientHandler
15.1.3 HttpClient.
15.2 客戶端消息處理管道.
15.2.1 HttpMessageHandler 管道.
15.2.2 HttpClientFactory .
15.3 面向"對像"編程..
15.3.1 將數據對像寫入請求消息..
15.3.2 讀取HTTP 消息主體內容並反序列化為數據對像..
附錄A 實例列表.

我覺得大部分人都是“眼球動物”，他們關注的往往都是目光所及的東西。對於很多軟件從業者來說，他們對看得見（具有UI界面）的應用抱有極大的熱忱，但是對背後支撐整個應用的服務卻顯得較為冷漠。如果我們將整個“生態繫統”比喻成海面上漂浮的冰山，我們所能看到的隻是露出水面的冰山一角，水面之下纔是一個“龐然大物”。
提到服務，我們自然想到Web Service。但是傳統意義上的Web Service卻有點名不副實，因為支撐它的其實不是Web而是SOAP，承載一個Web Service甚至可以根本不需要Web。隨著互聯網的普及，互聯網應用（尤其移動互聯網應用）已經成為主流，“SOAP之重”已經越來越令我們無法承受，於是采用REST架構風格並直接采用Web進行通信的輕量級Web Service走進了我們的視野並登堂入室。為了與傳統的基於SOAP的Web Service進行區分，我們將後者稱為Web API。
很多人鼓吹SOAP已死，我個人對此持不同的看法。上面講的“重”與“輕”都是不帶任何感情色彩的中性詞，至於優劣評價則決定於它們是否適合應用的場景。到目前為止，對於企業級應用之間的內部集成互聯，我覺得傳統的Web Service依然是最好的選擇。傳統Web Service應用的領域貌似在不斷被Web API占據，但是後者並不能完全被視為前者的替代品，它隻是讓“踩過界”的Web Service退回到它應該堅守的領地。Web Service和Web API在各自適合的領域各司其職，形成一種理想的“路歸路、橋歸橋”的狀態。
Web Service和Web API的合理布局同樣也體現在微軟技術平臺上。WCF在過去是唯一的選擇，這是一個具有“SOAP”基因的通信平臺，微軟後來利用擴展讓它提供了針對REST的支持。正因為如此，如果使用WCF來構建Web API的話，我們依然需要采用傳統的編程方式，Web API的“簡單、快捷”完全得不到體現。微軟意識到在一個“重量級”通信框架上通過擴展實現“輕量級”的通信，還不如重新構建一個通信平臺，於是ASP.NET Web API應運而生。
這不是一本傳統意義上的入門書籍
任何一本書都具有對應的受眾群體，所以我不得不將這句話放在最前面，並且希望所有打算購買此書的讀者能夠看到。如果你之前對ASP.NET Web API（或者ASP.NET MVC）完全沒有概念，在某一天突然被安排去開發一個需要使用到ASP.NET Web API的項目，你希望有那麼一本書能夠在一個星期或者更短的時間內幫助你掌握ASP.NET Web API基本的編程方式，那麼這本書不適合你。
我個人很喜歡金庸和古龍的武俠小說，我覺得學習某種開發框架就像是練一門武功。一門武功具有“招式”和“心法”之分，外在的招式可以速成，而內功心法絕非一蹴而就，但是沒有內功心法支撐的招式隻是花拳繡腿。對於某種開發框架來說，基本的編程模式就是招式，框架本身的設計就是心法。
“訓練招式”和“傳授心法”的書我們都需要，並且不能根據這點來評判一本書的優劣。就本書而言，這是一本苦練內功心法的書。對於大部分讀者來說，我覺得在很短的時間內完全掌握本書的內容並不是一件容易的事情，所以如果你沒有決定花較多的時間和精力閱讀此書的話，我還是建議你選擇其他相關的書籍。
我在《ASP.NET MVC 4框架揭秘》一書中寫過這麼一段話：“掌握ASP.NET MVC具有三個層次，了解基本的編程模式為第一層次，能夠清晰認識ASP.NET MVC框架本身從請求接收到響應回復的整個流程為第二層次，最高的層次則是能夠靈活自由地利用ASP.NET MVC提供的擴展點解決開發過程的實際問題”。這句話同樣適用於針對ASP.NET Web API的學習，本書寫作的目的是使第一層次的讀者快速進入第二層次和第三層次。
這是一本實用的書嗎
可能有人覺得這本講述ASP.NET Web API架構設計和剖析框架運行原理的書沒有什麼“實際”的意義，因為我們每天的日常工作就是編程，知道了ASP.NET Web API從請求接收到響應回復之間的整個處理流程並不會對實際工作產生實質性的改變。其實這種想法是極端錯誤的，因為我們編寫的程序最終是在框架上運行的，程序的高效性決定於它是否能夠最大限度地“迎合”框架的運行機制，所以了解ASP.NET Web API框架的運行原理有利於我們寫出高質量的程序。
常年以來，我個人的主要工作就是維護和設計公司內部的一個開發框架。這是一個在集團內部廣泛采用的針對.NET的開發框架，它的存在使流水線式的軟件開發成為可能，這個框架不僅僅提高了生產效率和產品質量，還降低了對最終開發人員技能的要求。之所以能夠做到這一點，原因在於幾乎所有與業務無關的功能（比如日志、異常處理、權限控制、安全審核、事務處理等）都由這個框架來完成，最終的開發人員隻需要實現具體的業務邏輯就可以了。
對於這個開發框架來說，針對相應開發技術所做的擴展和工具是一個重要的組成部分，所以出於本職工作的需要，我不得不對采用的主流開發技術進行深入研究，因為隻有在對其內部運行原理了然於胸的情況下纔能精準地找到一個最適合的擴展點來解決具體項目開發過程中遇到的問題。很多讀者都問過我同樣一個問題：“為什麼你能夠了解那麼多關於WCF、ASP.NET MVC和ASP.NET Web API這些技術的內部細節？”我現在告訴你們答案：因為這是我本職工作的一部分。為了將這些實用的研究成果服務於更多的人，我將它們寫到我的多本書中。
可以將本書當成一本講述設計架構的書來讀
在我的周圍存在著這樣一些人，這些人以剛畢業一兩年的大學生為主，他們大都工作勤奮、聰明好學，手中經常捧著GoF的《設計模式》，總是希望將書中的設計模式應用到具體項目之中，或者希望通過項目的實踐來印證他們在書本上學到的設計模式，但是理論和實踐之間的距離總讓他們感到困惑。
要從真實的項目或者產品中學習“實用”的軟件架構設計知識，先得確定目標項目或者產品中采用的架構思想和設計模式是正確的，而我們參與的很多項目其實被“架構”得一塌糊塗。對於像ASP.NET這樣的產品，其基礎架構能夠在很長一段時間內保持不變，本身就證明了應用在上面的架構設計的正確性，它們不正是我們學習架構設計最好的素材嗎！
就我個人而言，很多設計架構方面的知識都是近年來在深入研究WCF、ASP.NET MVC、ASP.NET Web API、Enterprise Library和Unity這些開發技術和開源框架的過程中獲取的。對於那些隻會拿貓、狗這些東西舉例的設計模式的書籍來說，這些內容是學不到的。本書除了介紹一些技術細節，實際上還將ASP.NET Web API的整個架構設計展現在了讀者面前，相信有心的讀者會從中學到不少關於架構設計方面的知識。
如果你手頭剛好有一本《ASP.NET MVC 4框架揭秘》（《ASP.NET MVC 5框架揭秘》也即將出版），可以將這兩本書對照著一起看。對於相同的功能點，認真思考一下為何它們在ASP.NET MVC和ASP.NET Web API中會采用不同的設計，兩種設計孰優孰劣，我想收獲會更大。
本書承載了個人針對新技術的學習方法
在過去幾年中，有些熱心的讀者和網友都向我咨詢過一個問題：“對於一門新的技術，如何能夠在短時間內掌握其精髓”。這是一個學習方法的問題，雖然我覺得每個人都有適合自己的學習方法，但我還是刻意地將我個人采用的方式體現在本書之中，希望它對某些讀者有用。如果讀者是個有心人，應該可以看到我在介紹某個知識點的時候，不僅僅會告訴你“是什麼”和“為什麼”，還會告訴你“如何證明是這樣”。換句話說，我不僅僅將某個論點拋給你，還為你展現了整個論證的過程，實際上我在學習過程中就是這麼做的。
本書的寫作特點
本書具有一個與其他中文原創或者翻譯書籍截然不同的特點，那就是幾乎所有的術語都采用英文，比如HttpController、Action和Model，在本書中並沒有翻譯成中文“HTTP控制器”、“操作”和“模型”。因為我認為很多術語其實很難找到一個語義完全等同的中文詞組或短語與之對應，對於習慣了將英文作為“開發語言”的讀者來說，強行翻譯其實是不必要的。
除此之外，這不是一本純理論的書，而是一本“實證型”的書，在書中提供了120個可供單獨下載的實例。這些實例在本書中具有不同的作用，有的是為了探測和證明對應的論點，有的是為了演示所使用的某種編程技巧。
本書讀者
雖然這不是一本傳統意義上的入門書籍，但是我不會根據讀者的技能將某一部分人排除在本書的讀者之外。與市面上絕大部分同類書籍相比，我寧願說這本書走得更遠而不是鑽得更深，因為雖然本書更加近距離地觸及了ASP.NET Web API框架內核，但是涉及的內容本身並沒有什麼高深莫測之處，對於具有基本.NET基礎的讀者應該都看得懂。所以我覺得本書適合那些對深層次了解ASP.NET Web API的開發人員和架構師，不論讀者處於怎樣的層次總會找到自己知識的“盲點”。
關於作者
蔣金楠（網名Artech），《WCF全面解析》（上、下冊）、《ASP.NET MVC 4框架揭秘》《ASP.NET MVC 5框架揭秘》等多部暢銷IT圖書作者，現就職於一家知名軟件公司擔任高級軟件顧問。擁有一個訪問量超過200萬的個人博客（），被評為2012年度51 CTO 十大傑出IT博客。2007~2013年被連續7次評為微軟MVP，同時也是少數幾個跨多領域（Solutions Architect、Connected System、Microsoft Integration和ASP.NET/IIS）的MVP之一。
致謝
本書得以出版，需要感謝本書的編輯張春雨和劉舫，他們的專業水準和責任心為本書提供了質量保證，多次合作產生的默契讓我對下次合作充滿期待。此外，最需要感謝的是我的妻子徐妍妍，隻有我知道她在本書提交給出版社之前所做的校對工作有多麼重要。
本書支持
本書針對最新版本的ASP.NET Web API，同時涉及太多底層實現的內容，所以大部分內容是找不到任何現成參考資料的，這些內容大都來自於作者對源碼的分析和試驗的證明。本書的最初版本是根據ASP.NET MVC Web API 2 Beta撰寫的，後來微軟發布了正式版，然後作者根據正式版對原來的內容進行了大量改動。這些因素加上作者自身能力的限制，都可能造成一些無法避免的錯誤或者偏差，如果讀者在閱讀過程中發現了任何問題，希望能夠反饋給我。如果讀者遇到任何ASP.NET MVC、ASP.NET Web API或者WCF的問題，也歡迎與我通過以下方式進行交流。
作者博客：
作者微博：
電子郵箱：
微信公眾賬號：Artech1981
本書的每一章節都會提供一繫列實例演示，讀者可以根據編號（如S101、S202 等）從下載的源代碼壓縮包中找到對應的實例。本書的附錄列出了可供下載的所有實例演示的列表和相關描述。源代碼的下載地址為：。

……