Restful web Services ----第 2章 筆記
識別資源
開發RESTful Web 服務的首要步驟之一就是設計資源模型，資源模型對所有客戶端用來與服務器交互的資源加以識別和分類。
如何選擇資源粒度
通過網絡效率、表達的多少以及客戶端的易用程度來幫助確定資源的粒度。
粗粒度設計便于富客戶端應用程序。而更精細的資源粒度可以更好地滿足緩存的要求。因此，應從客戶端和網絡的角度確定資源的粒度。下列因素可能會進一步影響資源粒度：
- 可緩存性
- 修改頻率
- 可變性
仔細設計資源粒度，以確保使用更多緩存，減小修改頻率；或將不可變數據從使用緩存較少、修改頻率更高或可變數據分離出來，這樣可以改善客戶端和服務端的效率。
如何將資源組織為集合
將資源組織為集合，可以讓客戶端及服務器將一組資源視為一個資源來引用，在集合上執行查詢，甚至將集合作為工廠來創建新資源。
基于應用程序特有條件來識別相似的資源，常見的例子有，共享同一數據庫Schema 的資源、有相同特性attribute或屬性property的資源或客戶端看起來是相似的資源。
如何支持計算或處理函數
將處理函數視為一個資源，使用HTTP GET來獲取表述，其中包含處理函數輸出。使用查詢參數來為處理函數提供輸入。REST只適用于應用程序領域中的“事物”或“實體”資源，這是對REST架構約束最常見的理解之一。
何時及如何使用控制器來操作資源
就RESTful Web服務而言，控制器能幫助提升服務器與客戶端的獨立程度，改善網絡效率，并讓服務器以原子操作的形式來實現復雜操作。控制器是一種能以原子方式修改資源的資源，它能幫助服務器抽象復雜的業務操作，并為客戶端提供觸發這些操作的途徑。
例子：
客戶端向要提供某書的30天免費在線版本，并帶有15%折扣。服務器上維護了一個集合，其中包含所有正在提供30天免費訪問的圖書，客戶端可以提交POST請求將該書添加到集合中：
#向三十天免費訪問圖書列表添加圖書的請求
POST /30daybookoffers HTTP/1.1
Host: www.example.org
Content-Type:application/x-www-urlencoded
id=1234&from=2009-10-10&to=2000-11-10
#響應
HTTP/1.1 201 Created
Location: http://www.example.org/30dayebookoffer/1234
Content-length:0
如果業務上要求以原子凡是完成這兩個修改，那么可以使用控制器資源：即添加折扣及30天免費訪問的請求。
在請求中，參數op=updateDiscount和 op=30dayOffer用來標識操作，這樣就會導致穿隧，穿隧會降低協議層面上的可見性，因為請求的可見部分（例如請求URI、使用HTTP方法、請求頭和媒體類型）并不會明確地描述操作。要不惜一切代價避免穿隧，針對每個操作使用不同的資源。
