Spring 指南（了解REST）

Apollo 發(fā)布于2019-08-16 14:39 / 873人閱讀

摘要：表示傳輸或以表示數(shù)據(jù)對象和屬性。僅更新上實(shí)體的指定字段，請求既不安全也不是冪等，這是因?yàn)椴僮鳠o法確保整個(gè)資源已更新。刪除為的地址狀態(tài)碼狀態(tài)碼表明請求的結(jié)果。

了解REST

REST（Representational State Transfer）由Roy Fielding于2000年在他的博士論文中引入和定義，REST是用于設(shè)計(jì)分布式系統(tǒng)的架構(gòu)風(fēng)格，它不是標(biāo)準(zhǔn)，而是一組約束，例如無狀態(tài)，具有客戶端/服務(wù)器關(guān)系和統(tǒng)一接口，REST與HTTP并不嚴(yán)格相關(guān)，但最常與它相關(guān)聯(lián)。

REST原則

資源公開易于理解的目錄結(jié)構(gòu)URI。

表示傳輸JSON或XML以表示數(shù)據(jù)對象和屬性。

消息顯式使用HTTP方法（例如，GET、POST、PUT和DELETE）。

無狀態(tài)交互在請求之間不在服務(wù)器上存儲客戶端上下文，狀態(tài)依賴性限制和限制可伸縮性，客戶端保持會話狀態(tài)。

HTTP方法

使用HTTP方法將CRUD（創(chuàng)建、檢索、更新、刪除）操作映射到HTTP請求。

GET

檢索信息，GET請求必須是安全且冪等的，這意味著無論使用相同參數(shù)重復(fù)多少次，結(jié)果都是相同的，它們可能有副作用，但用戶不期望它們，因此它們對系統(tǒng)的操作不是至關(guān)重要的，請求也可以是部分的或有條件的。

檢索ID為1的地址：

GET /addresses/1

POST

請求URI上的資源對提供的實(shí)體執(zhí)行某些操作，POST通常用于創(chuàng)建新實(shí)體，但也可用于更新實(shí)體。

創(chuàng)建一個(gè)新地址：

POST /addresses

PUT

將實(shí)體存儲在URI中，PUT可以創(chuàng)建新實(shí)體或更新現(xiàn)有實(shí)體，PUT請求是冪等的，冪等性是PUT與POST請求的期望之間的主要區(qū)別。

修改ID為1的地址：

PUT /addresses/1

注意：PUT替換現(xiàn)有實(shí)體，如果僅提供數(shù)據(jù)元素的子集，則其余數(shù)據(jù)元素將替換為空或null。

PATCH

僅更新URI上實(shí)體的指定字段，PATCH請求既不安全也不是冪等（RFC 5789），這是因?yàn)?b>PATCH操作無法確保整個(gè)資源已更新。

PATCH /addresses/1

DELETE

請求刪除資源，但是，不必立即刪除資源，它可能是異步或長時(shí)間運(yùn)行的請求。

刪除ID為1的地址：

DELETE /addresses/1

HTTP狀態(tài)碼

狀態(tài)碼表明HTTP請求的結(jié)果。

1XX — 信息

2XX — 成功

3XX — 重定向

4XX — 客戶端錯(cuò)誤

5XX — 服務(wù)器錯(cuò)誤

媒體類型

Accept和Content-Type HTTP頭可用于描述HTTP請求中發(fā)送或請求的內(nèi)容，如果客戶端正在請求JSON格式的響應(yīng)，則可以將Accept設(shè)置為application/json，相反，在發(fā)送數(shù)據(jù)時(shí)，將Content-Type設(shè)置為application/xml會告訴客戶端請求中發(fā)送的數(shù)據(jù)是XML。