RESTful教學


RESTful Web服務是基於REST架構的Web服務。在REST架構一切都是一種資源。 RESTful Web服務是輕量級的,高度可延伸性和可維護性,並且非常常用於建立基於API的Web應用程式。

REST是什麼 ?

REST表示代表性狀態傳輸。REST是一種基於Web標準的架構,並使用HTTP協定進行資料通訊。它圍繞著資源,其中每一個元件是資源和一個資源是由一個共同的介面,使用HTTP的標準方法獲得。REST最初是由Roy Fielding在2000年推出。

在REST架構中,REST伺服器只是提供的資源以及在REST用戶端存取時提供資源。這裡每個資源由URI標識/全域性標識。REST採用各種申述表示類似文字,JSON和XML資源。現在JSON是Web服務所使用的最流行的格式。

HTTP 方法

下列著名的HTTP方法是常用於基於REST的架構。

  • GET - 提供的資源的唯讀存取。

  • PUT - 用於建立一個新的資源。

  • DELETE - 用於刪除資源。

  • POST - 用於更新現有資源或建立新的資源。

  • OPTIONS - 用於得到支援的操作上的資源。

RESTful Web服務

Web服務是用於交換應用程式或系統之間的資料開放的協定和標準的集合。編寫各種程式設計語言和執行在不同平台上的軟體應用程式可以使用Web服務來以類似於進程間通訊在單台計算機上的方式通過計算機網路進行交換資料,如因特網。 這份互聯特性(如Java和Python,或Windows和Linux應用程式之間),是由於使用開放標準。

基於REST架構的Web服務稱為RESTful web服務。這些Web服務使用HTTP方法來實現REST架構的概念。RESTful Web服務通常定義URI,統一資源識別符號的服務,提供資源的表示,如JSON,並設定HTTP方法。

建立RESTful Web服務

本教學將建立一個Web服務使用以下使用者管理功能:

Sr. No. HTTP 方法 URI 操作 操作型別
1 GET /UserService/users 獲取使用者列表 唯讀
2 GET /UserService/users/1 讀取使用者ID為1使用者資訊 唯讀
3 PUT /UserService/users/2 插入Id為2的使用者資訊 等冪
4 POST /UserService/users/2 更新Id為2的使用者資訊 N/A
5 DELETE /UserService/users/1 刪除Id為1的使用者資訊 等冪
6 OPTIONS /UserService/users 列出Web服務支援的操作 唯讀