前言 i
第1章 使用統一接口 1
1.1 如何保持交互的可見性 2
1.2 何時需要權衡可見性 4
1.3 如何維護應用程序狀態 6
1.4 如何在服務器端實現安全和冪等的方法 9
1.5 如何在客戶端處理安全和冪等方法 12
1.6 何時使用get方法 13
1.7 何時使用post方法 15
1.8 如何使用post方法創建資源 17
1.9 何時使用put方法創建新資源 19
1.10 如何使用post方法實現異步任務 20
1.11 如何使用delete方法實現異步刪除 23
1.12 何時使用自定義http方法 24
1.13 何時及如何使用自定義http標頭 26
第2章 識彆資源 29
2.1 如何從領域名詞中識彆資源 30
2.2 如何選擇資源粒度 31
2.3 如何將資源組織為集閤 32
.2.4 何時將資源閤並為復閤資源 35
2.5 如何支持計算或處理函數 37
2.6 何時及如何使用控製器來操作資源 40
第3章 設計錶述 45
3.1 如何使用實體頭來注解錶述 46
3.2 如何解釋實體頭 50
3.3 如何避免字符編碼不匹配 51
3.4 如何選擇錶述格式和媒體類型 52
3.5 如何設計xml錶述 56
3.6 如何設計json錶述 58
3.7 如何設計集閤錶述 59
3.8 如何保持同構的集閤 61
3.9 如何在錶述中使用可移植的數據格式 63
3.10 何時使用實體標識符 65
3.11 如何在錶述中編碼二進製數據 66
3.12 何時以及如何提供html錶述 68
3.13 如何返迴錯誤 70
3.14 如何在客戶端處理錯誤 74
第4章 設計uri 77
4.1 如何設計uri 77
4.2 如何將uri用做模糊標識符 81
4.3 如何讓客戶端將uri視為模糊標識符 83
4.4 如何保持酷的uri 85
第5章 web鏈接 88
5.1 如何在xml錶述中使用鏈接 89
5.2 如何在json錶述中使用鏈接 92
5.3 何時以及如何使用鏈接標頭 93
5.4 如何分配鏈接關係類型 94
5.5 如何使用鏈接來管理應用程序的流程 97
5.6 如何處理臨時uri 101
5.7 何時以及如何使用uri模闆 103
5.8 如何在客戶端使用鏈接 105
第6章 atom和atompub 108
6.1 如何利用atom建模資源 109
6.2 何時使用atom 113
6.3 如何使用atompub服務和分類文件 117
6.4 如何針對feed和entry資源使用atompub 119
6.5 如何使用媒體資源 122
第7章 內容協商 125
7.1 如何標明客戶端偏好 126
7.2 如何實現媒體類型協商 128
7.3 如何實現語言協商 129
7.4 如何實現字符編碼協商 131
7.5 如何支持壓縮 132
7.6 何時以及如何發送vary頭 133
7.7 如何處理協商失敗 134
7.8 如何使用代理驅動的內容協商 136
7.9 何時支持服務器驅動的協商 137
第8章 查詢 139
8.1 如何針對查詢設計uri 139
8.2 如何設計查詢響應 142
8.3 如何支持有大量輸入的查詢請求 144
8.4 如何存儲查詢 146
第9章 web緩存 149
9.1 如何設置過期緩存頭 150
9.2 何時設置過期緩存頭 153
9.3 何時以及如何在客戶端中使用過期緩存頭 156
9.4 如何支持復閤資源的緩存 157
9.5 如何保持新鮮且溫暖的緩存 158
第10章 條件請求 161
10.1 如何生成last-modified和etag頭 163
10.2 如何在服務器端實現條件get請求 164
10.3 如何從客戶端提交條件get和head請求 167
10.4 如何在服務器端實現條件put請求 169
10.5 如何在服務器端實現條件delete請求 173
10.6 如何從客戶端發起無條件get請求 175
10.7 如何從客戶端提交條件put和delete請求 176
10.8 如何使post請求條件化 178
10.9 如何生成一次性uri 181
第11章 其他內容 184
11.1 如何復製資源 185
11.2 如何閤並資源 187
11.3 如何移動資源 189
11.4 何時使用webdav方法 191
11.5 如何支持跨服務器的操作 193
11.6 如何獲取資源的快照 195
11.7 如何撤銷資源更新 198
11.8 如何為部分更新提煉資源 200
11.9 如何使用patch方法 203
11.10 如何批量處理相似的資源 206
11.11 如何觸發批量操作 209
11.12 何時使用post來閤並多個請求 211
11.13 如何支持批量請求 215
11.14 如何支持事務 217
第12章 安全 220
12.1 如何使用基本身份驗證來驗證客戶端 221
12.2 如何使用摘要身份驗證來驗證客戶端 224
12.3 如何使用三方oauth 226
12.4 如何使用兩方oauth 232
12.5 如何處理uri中的敏感信息 235
12.6 如何維護錶述的機密性與完整性 237
第13章 可擴展性與版本控製 239
13.1 如何維持uri的兼容性 240
13.2 如何維持xml和json錶述的兼容性 242
13.3 如何擴展atom 245
13.4 如何維持鏈接的兼容性 249
13.5 如何實現支持可擴展性的客戶端 250
13.6 何時需要版本化 251
13.7 如何版本化restful web服務 252
第14章 服務發現 256
14.1 如何編寫restful web服務的文檔 256
14.2 如何使用options 259
附錄a 輔助讀物 261
附錄b rest概述 265
附錄c http方法 268
附錄d atom syndication format 273
附錄e 鏈接關係類型 279
索引 287
· · · · · · (收起)