深入了解 PUT 和補丁請求。開發人員或程序員應該知道和請求之間的區別。似乎兩者都在修改資源中的數據。僅此而已嗎?或者,如果在面試中問過你這個問題,你現在會怎么回答?PUTPATCH今天我們就來聊聊這個話題。
1. 安全和冪等 HTTP 方法
安全方法
在 REST API 的上下文中,安全方法是不修改資源的 HTTP 方法。例如,在 上使用 GET 或 HEAD 永遠不應更改資源。安全方法是可以緩存和預取而對資源沒有任何影響的方法。Request URI
在實踐中,通常不可能以不改變任何資源的方式實現安全方法。例如,GET 請求可能會創建日志或更新統計信息值,或者在服務器上觸發緩存刷新。
無法確保服務器不會因執行 GET 請求而產生副作用。這里的重要區別在于API消費者沒有請求副作用,因此消費者不能對它們負責。
請求 URI 是應用請求的資源的統一資源標識符。
冪等方法
如果一個或多個 HTTP 方法的調用對資源具有相同的預期效果,則將此方法視為 。如果該方法只被調用了一次或三次,這應該無關緊要。資源上的結果應始終相同。idempotent
Idempotency本質上意味著成功執行的請求的結果與它被執行的次數無關。
注意:當您發送多個 DELETE 請求時,第一個請求將刪除資源,響應為 200(正常)或 204(無內容)。下一個請求返回 404(未找到)。響應與第一個請求不同,但由于原始資源已被刪除,因此服務器端的任何資源的狀態都沒有變化。因此,刪除是冪等的。
2. 看跌期權請求
該方法完全修改現有資源或創建新資源。它是如何做到的?PUT
API 使用者發送資源 ID
如果資源存在,則整個資源將替換為整個實體
如果資源不存在,則會創建一個新資源
例如,如果要更改數據庫中用戶的名字,則需要在發出請求時發送整個實體。PUT
要發出請求,您需要發送所有參數,而不僅僅是名稱;此示例的第一個和姓氏。PUT
如果成功更新,則成功的請求將返回 of 或 of,如果預期資源尚無當前表示形式,并且請求創建一個表示形式,則源服務器必須向 API 使用者發送 of 響應。PUTHTTP Status Code200 (OK)HTTP Status Code204 (No Content)PUTHTTP Status Code201 (Created)
3. 為什么 PUT 請求是冪等的
此處,請求包含此用戶的所有參數。PUT
使用請求時,假定您正在發送完整的實體,并且完整的實體將替換 處的任何現有資源。 請求通過替換整個資源來處理它。PUT Request URIPUT
由于請求包括整個實體,因此如果您重復發出相同的請求,它應該始終具有相同的結果(您發送的數據現在是資源的全部數據)。PUT
如果您發送請求5次,則第一個請求將更新資源;其他 4 個請求將一次又一次地覆蓋相同的資源狀態 — 實際上不會更改任何內容。PUT
因此,該請求是冪等的。PUT
4. 補丁請求
該方法將部分更新應用于現有資源。這意味著您只需要發送要更新的數據,而不會影響或更改任何其他內容。因此,如果要更新數據庫中的名字,則只需發送第一個參數。對于上面的示例,此參數是第一個名稱。PATCH
API 使用者發送資源 ID
如果資源存在,則會部分更新現有資源(并非所有實體都是必需的)。
如果資源不存在,則返回 ofHTTP Status Code404 (Not Found)
成功的請求如果成功更新,則返回 of 或 of。PATCHHTTP Status Code200 (OK)HTTP Status Code204 (No Content)
5. 為什么 PATCH 請求是非冪等的
該方法更新資源的一小部分。例如,如果使用請求更新資源,并且未設置所有字段,則可能會丟失留空字段中的數據。 request 修復了此問題,因為它僅更新請求正文中聲明的特定部分。PATCH PUT PATCH
PATCH請求并不總是保證相同的效果,所以它不是。換句話說,它可能會影響 的不同部分的更改。idempotent Request URI
在上面的示例中,只需更改用戶資源的名字字段。然后向同一資源發出請求并修改同一資源的不同字段。Request URI
在前兩個示例中,在第一個請求中修改了第一個姓名字段,在第二個請求中修改了姓氏字段。結果,向同一資源發出了兩個請求,并在每個請求上獲得了不同的結果。
對方法的此更改會根據要更新的資源部分提供不同的結果。因此,不是冪等的。PATCH PATCH
高級說明: 可以使用 和 HTTP 標頭使請求具有冪等性。PATCH ETagIf-Modified-Since
6. 何時使用 PUT 和補丁請求
當 API 使用者需要完全替換現有資源時,使用者可以使用該方法。當使用者想要進行部分更新時,他們可以使用該方法。PUT PATCH
例如,在更新資源的單個字段時,發送整個實體表示形式可能會很麻煩,并且會占用大量不必要的帶寬。在這種情況下,該方法的使用更有意義。PATCH
7. PUT 和補丁請求之間的差異
和 請求之間的主要區別在于服務器處理發送的實體以更新由 標識的資源。發出請求時,發送的實體被視為保存在原始服務器上的資源的修改版本,并且 API 使用者請求對其進行更改。但是,隨請求一起發送的實體具有一組說明,這些說明描述了如何部分修改存儲在原始服務器上的資源以創建新版本。PUT PATCH Request URI PUT PATCH
這里要考慮的另一個重要方面是冪等性。該方法是冪等的,該方法可以是冪等的,但不是必需的。您可以根據實現位置選擇一個或另一個。PUT PATCH
結論
希總結一下本文,這些方法之間的主要區別在于冪等的,以及它們如何處理來自 API 使用者的請求。在面試中可能會問到你這個問題。
所有 HTTP 方法的范圍和語義