RESTful Web 服務 - 資源



什麼是資源?

REST 架構將所有內容都視為資源。這些資源可以是文字檔案、HTML 頁面、影像、影片或動態業務資料。REST 伺服器只提供對資源的訪問,而 REST 客戶端訪問並修改資源。這裡每個資源都由 URI/全域性 ID 標識。REST 使用各種表示來表示資源,例如文字、JSON、XML。最流行的資源表示是 XML 和 JSON。

資源的表示

REST 中的資源類似於面向物件程式設計中的物件,或類似於資料庫中的實體。一旦識別出資源,就需要使用標準格式確定其表示形式,以便伺服器可以使用上述格式傳送資源,並且客戶端可以理解相同的格式。

例如,在RESTful Web 服務 - 第一個應用章節中,使用者是一個資源,使用以下 XML 格式表示:

<user> 
   <id>1</id> 
   <name>Mahesh</name>
   <profession>Teacher</profession> 
</user> 

相同的資源可以用 JSON 格式表示如下:

{ 
   "id":1, 
   "name":"Mahesh", 
   "profession":"Teacher" 
}

良好的資源表示

REST 並不對資源表示的格式施加任何限制。一個客戶端可以請求 JSON 表示,而另一個客戶端可以請求同一資源的 XML 表示,等等。REST 伺服器有責任以客戶端理解的格式向客戶端傳遞資源。

以下是在設計 RESTful Web 服務中資源表示格式時需要考慮的一些要點。

  • 可理解性 - 伺服器和客戶端都應該能夠理解和使用資源的表示格式。

  • 完整性 - 格式應該能夠完整地表示資源。例如,一個資源可以包含另一個資源。格式應該能夠表示簡單和複雜的資源結構。

  • 可連結性 - 一個資源可以與另一個資源連結,格式應該能夠處理這種情況。

然而,目前大多數 Web 服務都使用 XML 或 JSON 格式來表示資源。有很多庫和工具可用於理解、解析和修改 XML 和 JSON 資料。

廣告
© . All rights reserved.