#### 模型表示(Representations)
RESTful 服務的焦點在資源上和怎么提供對資源的訪問。資源很容易被認為和OOP中的對象一樣。一個資源能由其他資源組成。當設計一個系統的時候,第一件要做的事情是定義資源和決定資源之間的關系。這有點像設計數據庫的第一步。定義實體和關系。
一旦我們定義了資源,接下來我們需要找到一種用于在系統中表示這些資源的方法。你可以使用任何格式來表示資源。REST 對此沒有限制。
例如,根據你的需求,你可以決定使用 JSON 或者 XML。如果你在構建 Web 服務,此服務用于 Web 頁面中的 AJAX 調用,那 JSON 是很好地選擇。 XML 可以用來表示比較復雜的資源。例如一個被稱為“Person”的資源可以表示如下:
列表1:資源的JSON 表示。
~~~
{
"ID": "1",
"Name": "M Vaqqas",
"Email": "m.vaqqas@gmail.com",
"Country": "India"
}
~~~
列表2:資源的XML 表示。
~~~
<Person>
<ID>1</ID>
<Name>M Vaqqas</Name>
<Email>m.vaqqas@gmail.com</Email>
<Country>India</Country>
</Person>
~~~
實際上,你可以使用不止一種的格式并且決定使用其中哪一種用于依賴于客戶端類型或一些請求參數的響應。無論使用哪個格式,好的模型表示(representation )應該具有以下明顯的特征:
1. 客戶端和服務端應該能夠理解這種模型表示(representation )的格式。
2. 模型表示(representation )應該能夠完整的表示資源。如果需要表示部分資源,然后你需要考慮將資源分解成子資源。分割大資源到更小的資源同樣允許你傳遞更小的表現。較小的模型表示(representation)意味著更少的時間來創建和傳輸。這也意味著更快的服務。
3. 模型表示(representation)應該能夠互相鏈接資源。可以通過替換 URI 或者是唯一 ID。
- 《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 安全設計指南》