作者簡介　　XV
關於封麵圖　　XVI
序　　 XVII
前言　　XX
第一部分　基礎知識
第1章　因特網、萬維網和HTTP協議　　3
1.1　Web體係結構　　4
1.1.1　資源　　5
1.1.2　URI　　5
1.1.3　酷URI　　6
1.1.4　錶示　　6
1.1.5　媒體類型　　7
1.2　HTTP協議　　8
1.2.1　HTTP 1.1之後　　9
1.2.2　HTTP消息交換　　9
1.2.3　中間層　　10
1.2.4　中間層類型　　11
1.2.5　HTTP方法　　12
1.2.6　標頭　　15
1.2.7　HTTP狀態碼　　16
1.2.8　內容協商　　16
1.2.9　緩存　　16
1.2.10　身份驗證　　19
1.2.11　身份驗證方案　　20
1.2.12　附加身份驗證方案　　20
1.3　小結　　21
第2章　Web API　　22
2.1　什麼是Web API　　22
2.2　SOAP Web服務　　22
2.3　Web API的起源　　23
2.4　Web API革命開始　　23
2.5　關注Web　　23
2.6　Web API指南　　24
2.7　特定領域的媒體類型　　24
2.8　媒體類型檔案　　25
2.9　多個錶示　　26
2.10　API 風格　　27
2.10.1　Richardson成熟度模型　　28
2.10.2　RPC（RMM 第0級）　　28
2.10.3　資源（RMM 第1級）　　30
2.10.4　HTTP 謂詞（RMM 第2級）　　32
2.10.5　以資源為中心的API　　34
2.10.6　超媒體（RMM 第3級）　　35
2.10.7　REST　　39
2.10.8　REST約束　　39
2.11　小結　　41
第3章　ASP.NET Web API 101　　42
3.1　核心場景　　42
3.1.1　第一類HTTP編程　　43
3.1.2　對稱的客戶端和服務器編程體驗　　44
3.1.3　對不同格式的靈活支持　　45
3.1.4　告彆“尖括號編碼”　　45
3.1.5　支持單元測試　　45
3.1.6　多種托管選項　　46
3.2　ASP.NET Web API入門　　46
3.3　新建Web API項目　　50
3.3.1　WebApiConfig　　50
3.3.2　ValuesController　　52
3.4“Hello Web API!”　　53
3.4.1　創建服務　　53
3.4.2　客戶端　　60
3.4.3　宿主　　60
3.5　小結　　61
第4章　處理架構　　62
4.1　托管層　　64
4.2　消息處理程序管道　　65
4.3　控製器處理　　69
4.4　小結　　75
第二部分　真實世界的API開發
第5章　應用程序　　79
5.1　為什麼要可演化　　80
5.1.1　演化的障礙　　81
5.1.2　代價是什麼　　81
5.1.3　為什麼不創建新版本　　83
5.1.4　付諸實踐　　86
5.2　應用程序目標　　86
5.2.1　目標　　86
5.2.2　機會　　87
5.3　信息模型　　87
5.3.1　子域　　88
5.3.2　相關資源　　88
5.3.3　屬性組　　89
5.3.4　屬性組的集閤　　90
5.3.5　信息模型與媒體類型　　90
5.3.6　問題集閤　　91
5.4　資源模型　　92
5.4.1　根資源　　92
5.4.2　搜索資源　　92
5.4.3　集閤資源　　92
5.4.4　個體資源　　93
5.5　小結　　95
第6章　媒體類型選擇與設計　　96
6.1　自描述　　96
6.2　協議類型　　97
6.3　媒體類型　　97
6.3.1　原始格式　　97
6.3.2　流行格式　　99
6.3.3　新格式　　100
6.3.4　超媒體類型　　102
6.3.5　媒體類型爆炸　　102
6.3.6　通用媒體類型和檔案　　102
6.3.7　其他超媒體類型　　106
6.4　鏈接關係類型　　107
6.4.1　語義　　107
6.4.2　替換嵌入資源　　109
6.4.3　間接層　　109
6.4.4　引用數據　　110
6.4.5　工作流　　 111
6.4.6　語法　　112
6.4.7　完美結閤　　114
6.5　設計新的媒體類型協議　　114
6.5.1　選擇格式　　115
6.5.2　支持超媒體　　116
6.5.3　可選、強製、省略和適用　　116
6.5.4　嵌入元數據和外部元數據　　117
6.5.5　可擴展性　　117
6.5.6　注冊媒體類型　　119
6.6　設計新的鏈接關係　　119
6.6.1　標準鏈接關係　　119
6.6.2　擴展鏈接關係　　120
6.6.3　嵌入鏈接關係　　121
6.6.4　注冊鏈接關係　　121
6.7　問題跟蹤域中的媒體類型　　121
6.7.1　list資源　　122
6.7.2　item資源　　123
6.7.3　discovery資源　　124
6.7.4　search資源　　125
6.8　小結　　125
第7章　構建API　　126
7.1　設計　　126
7.2　獲得源代碼　　127
7.3　使用行為驅動開發構建實現　　127
7.4　瀏覽解決方案　　127
7.5　軟件包和程序庫　　128
7.6　自托管　　128
7.7　模型和服務　　130
7.7.1　問題和問題庫　　130
7.7.2　IssueState　　130
7.7.3　IssuesState　　131
7.7.4　Link　　133
7.7.5　LinkeStateFactory　　133
7.7.6　LinkFactory　　134
7.7.7　IssueLinkFactory　　135
7.8　驗收標準　　136
7.9　功能：獲取問題　　139
7.9.1　獲取一個問題　　142
7.9.2　獲取未關閉的和已關閉的問題　　144
7.9.3　獲取不存在的問題　　146
7.9.4　獲取所有問題　　147
7.9.5　獲取所有問題的Collection+Json錶示　　150
7.9.6　搜索問題　　152
7.10　功能：創建問題　　153
7.11　功能：更新問題　　156
7.11.1　更新一個問題　　156
7.11.2　更新不存在的問題　　158
7.12　功能：刪除問題　　159
7.12.1　刪除一個問題　　159
7.12.2　刪除不存在的問題　　160
7.13　功能：處理問題　　161
7.13.1　測試　　161
7.13.2　實現　　161
7.14　小結　　163
第8章　改進API　　164
8.1　新功能的驗收標準　　164
8.2　實現輸齣緩存支持　　166
8.3　添加輸齣緩存測試　　167
8.4　實現緩存重驗證　　169
8.5　為緩存重驗證實現條件GET　　170
8.6　衝突檢測　　173
8.7　實現衝突檢測　　174
8.8　變更審計　　176
8.9　使用Hawk認證實現變更審計　　177
8.10　跟蹤　　181
8.11　實現跟蹤　　182
8.12　小結　　184
第9章　構建客戶端　　185
9.1　客戶端程序庫　　186
9.1.1　封裝庫　　186
9.1.2　鏈接用作函數　　189
9.2　應用程序工作流　　194
9.2.1　用戶需知　　195
9.2.2　帶有使命的客戶端　　198
9.2.3　客戶端狀態　　201
9.3　小結　　201
第三部分　Web API細節
第10章　HTTP編程模型　　205
10.1　消息　　206
10.2　標頭　　210
10.3　消息內容　　215
10.3.1　使用消息內容　　216
10.3.2　創建消息內容　　218
10.4　小結　　226
第11章　托管　　227
11.1　Web托管　　228
11.1.1　ASP.NET基礎結構　　228
11.1.2　ASP.NET路由　　230
11.1.3　Web API路由　　232
11.1.4　全局配置　　234
11.1.5　Web API ASP.NET處理程序　　235
11.2　自托管　　238
11.2.1　WCF 架構　　238
11.2.2　HttpSelfHostServer類　　240
11.2.3　HttpSelfHostConfiguration類 　　241
11.2.4　URL 預留和訪問控製　　242
11.3　用OWIN和Katana托管Web API　　243
11.3.1　OWIN　　244
11.3.2　Katana項目　　245
11.3.3　Web API配置　　247
11.3.4　Web API中間件　　248
11.3.5　OWIN生態環境　　250
11.4　內存托管　　250
11.5　Azure Service Bus Host　　252
11.6　小結　　256
第12章　控製器和路由　　257
12.1　HTTP消息流概覽　　257
12.2　消息處理程序管道　　258
12.2.1　分發程序　　262
12.2.2　HttpControllerDispatcher　　263
12.2.3　控製器選擇　　263
12.2.4　控製器激活　　266
12.3　控製器管道　　267
12.3.1　ApiController　　267
12.3.2　ApiController 處理模型　　268
12.4　小結　　279
第13章　格式化程序和模型綁定　　280
13.1　ASP.NET Web API中模型的重要性　　280
13.2　模型綁定如何工作　　281
13.3　內建的模型綁定器　　284
13.3.1　ModelBindingParameterBinder 　　284
13.3.2　值提供程序　　285
13.3.3　模型綁定器　　288
13.3.4　隻對URI進行模型綁定　　290
13.3.5　FormatterParameterBinder實現 　　291
13.3.6　HttpParameterBinding的默認選擇 　　296
13.4　模型驗證　　296
13.4.1　將數據標記屬性用於模型　　296
13.4.2　查詢驗證結果　　297
13.5　小結　　299
第14章　HttpClient　　300
14.1　HttpClient類　　300
14.1.1　生存周期　　301
14.1.2　封裝類　　301
14.1.3　多個實例　　302
14.1.4　綫程安全　　302
14.1.5　輔助方法　　302
14.1.6　抽絲剝繭　　303
14.1.7　完成的請求無異常　　303
14.1.8　內容為王　　303
14.1.9　取消請求　　304
14.1.10　SendAsync　　305
14.2　客戶端消息處理程序　　306
14.2.1　代理處理程序　　308
14.2.2　僞響應處理程序　　309
14.2.3　創建可以重用的響應處理程序 　　310
14.3　小結　　311
第15章　安全　　312
15.1　傳輸安全　　312
15.2　在ASP.NET Web API中使用TLS　　314
15.2.1　IIS 托管時使用TLS　　314
15.2.2　自托管時使用TLS　　316
15.3　身份驗證　　316
15.3.1　聲明模型　　317
15.3.2　獲取和設置當前用戶對象　　321
15.3.3　基於傳輸的身份驗證　　321
15.3.4　服務器身份驗證　　322
15.3.5　客戶端身份驗證　　325
15.3.6　HTTP身份驗證框架　　331
15.3.7　實現基於HTTP的身份驗證　　333
15.3.8　Katana身份驗證中間件　　334
15.3.9　主動和被動的身份驗證中間件 　　338
15.3.10　Web API身份驗證篩選器　　339
15.3.11　基於令牌的身份驗證　　342
15.3.12　Hawk身份驗證方案　　348
15.4　授權　　350
15.4.1　授權執行　　351
15.4.2　跨域資源共享　　354
15.4.3　ASP.NET Web API 的CORS支持 　　357
15.5　小結　　359
第16章　OAuth 2.0授權框架　　360
16.1　客戶端應用程序　　362
16.2　訪問受保護資源　　364
16.3　獲得訪問令牌　　365
16.4　授權碼授予　　367
16.5　範圍　　369
16.6　前通道與後通道　　370
16.7　刷新令牌　　371
16.8　資源服務器和授權服務器　　372
16.9　在ASP.NET Web API中處理訪問令牌 　　373
16.10　OAuth 2.0與身份驗證　　375
16.11　基於範圍的授權　　378
16.12　小結　　379
第17章　可測試性　　380
17.1　單元測試　　380
17.1.1　使用測試框架　　381
17.1.2　Visual Studio單元測試入門　　381
17.1.3　xUnit.NET　　383
17.1.4　單元測試在測試驅動開發中的作用 　　384
17.2　對ASP.NET Web API實現進行單元測試 　　387
17.2.1　測試ApiController　　387
17.2.2　測試MediaTypeFormmater　　393
17.2.3　單元測試HttpMessageHandler　　396
17.2.4　測試ActionFilterAttribute　　397
17.3　對路由進行單元測試　　401
17.4　ASP.NET Web API的集成測試　　402
17.5　小結　　404
附錄A　媒體類型　　405
附錄B　HTTP標頭　　406
附錄C　內容協商　　409
附錄D　緩存實戰　　413
附錄E　身份驗證工作流　　417
附錄F　application/issue+json媒體類型規範 　　420
附錄G　公鑰加密和證書　　422
· · · · · · (收起)