#### 資源定位
REST 要求每個資源至少有一個 URI。 RESTful 服務使用人類可讀的URIs層級目錄來定位資源。URI 要做的工作是定義一個資源或資源集合。實際的操作由 HTTP 動作決定。URI 應該沒有任何關于處理和動作的內容。這使我們能夠調用相同的 URI 使用不同的 HTTP 動詞來執行不同的操作。
假設我們有一個 person 的數據庫并且我們希望通過服務器暴露給外部。
Person 資源可以像下面這樣被定位到:
> http://MyService/Persons/1
此URL遵循格式:
> Protocol://ServiceName/ResourceType/ResourceID
對于構建良好的 URIs 這有些重要的推薦:
1. 使用復數名詞命名你的資源。
2. 避免使用制造混亂的空格。使用_或者-代替。
3. URI 不區分大小寫。為了更清晰我使用駝峰寫法。你也可以使用全部小寫的URIs。
4. 你也能夠有你自己的約定,但是要在整個服務保持一致。確保你的客戶端都知道這個約定。你的客戶端 URIs 程序構建將更簡單如果它們知道你遵循的資源層級和URI約定。
5. 好的 URI 是不會變更的。在決定服務的 URIs 之前要先思考思考。如果你需要改變資源的定位,不要放棄老的 URI。如果請求來自老的 URI,使用狀態碼300重定向客戶端到新的location。
6. 避免使用動詞命名你的資源直到你的資源是一個實際地操作或過程。動詞更加適合操作的命名。例如,RESTful 服務不應該有類似下面的 URI:
~~~
http://MyService/FetcthPerson/1
http://MyService/DeletePerson?id=1
~~~
- 《Restful Web Service Cookbook》
- 簡介
- 推薦序
- 第 1 章 使用統一接口
- 1.1 如何保持交互的可見性
- 1.2 何時使用 GET 方法
- 1.3 何時使用 POST 方法
- 1.4 如何使用 POST 方法創建資源
- 目錄
- PHP RESTful
- 理解RESTful架構
- 深入淺出REST
- 表述性狀態轉移
- 無狀態
- 設計指南
- RESTful API 設計指南
- RESTful API 設計最佳實踐
- 測試工具
- soapUI
- 實例
- 豆瓣
- 應用
- 接口規范
- 視頻
- 《Restful API實戰》
- 課程目標
- 第1章 Restful是什么
- 1-1 restful簡介及資源介紹
- 第2章 為什么要使用Restful
- 2-1 Restful中HTTP協議介紹
- 2-2 架構區別
- 第3章 如何使用Restful
- 3-1 restful設計要素
- 3-2 DHC Client
- 3-3 本地開發環境搭建
- 3-4 確認設計要素
- 3-5 數據庫設計
- 3-6 用戶業務邏輯
- 3-7 文章業務邏輯
- 3-8 restfulApi設計要素
- 3-9 初始化運行參數
- 3-10 完善用戶API
- 3-11 完善文章API
- 文摘
- RESTful 接口實現簡明指南
- RESTful Web 服務教程
- 模型表示(Representations)
- 資源定位
- URI中的查詢參數
- 統一接口
- PUT 和 POST 的區別
- 基于 REST 的 Web 服務
- PHP Reatful
- Restful狀態響應碼
- 《REST API 安全設計指南》