1. 程式人生 > >REST統一介面 GET PUT DELETE POST

REST統一介面 GET PUT DELETE POST

冪等性:idempotence 指外系統對同一REST介面的多次訪問,得到的資源狀態是相同的。

1、GET 方法

REST使用HTTP的GET方法獲取服務提供的資源。GET方法是隻讀的。他是冪等和安全的。

@GET方法註釋對資源方法定義,使得該方法用於處理GET請求。

在介面中抽象地定義了資源的請求方法後,其全部的實現類都無須再定義。

在測試類中註冊的是實現類而不是介面類

HEAD方法和GET方法相似,只是服務端的返回值不是HTTP實體。@HEAD

OPTIONS方法和GET方法相似,用於讀取資源所支援的(ALLOW)所有HTTP請求方法。@OPTION

2.PUT方法

PUT方法是一種寫操作的HTTP請求。REST使用HTTP的PUT方法更新或新增資源。

建立操作通常設計為POST方法的API,唯有客戶端在發起建立請求時,在同一份資料中總可以提供唯一的主鍵值,伺服器不會對其進行修改,這樣的請求確保了冪等性,不應在使用POST方法

媒體型別

@Consumes(Media Type。APPLICATION_XML)定義了服務端要消費的媒體型別,即消費客戶端請求實體的媒體型別

@Produces (MediaType。TEXT_PLAIN)定義了伺服器端產生的媒體型別,即服務端產生的響應實體的媒體型別。

3DELETE方法

DELETE是冪等的,  @DELETE 

4.POST方法

POST方法是一種寫操作的HTTP請求。  既不等冪也不安全

GET方法用於讀取、檢索、查詢、過濾一個資源

PUT用於修改、更新資源,建立客戶端維護主鍵資訊的資源

DELETE 方法用於刪除資源

POST方法用於建立資源