1. 什么是冪等性?
HTTP 冪等方法,是指無論調用多少次都不會有不同結果的HTTP方法。不管你調用一次,還是調用一百次,一千次,結果都是相同的。 GET /tickets # 獲取ticket列表 GET /tickets/12 # 查看某個具體的ticket POST /tickets # 新建一個ticket PUT /tickets/12 # 更新ticket 12 PATCH /tickets/12 # 更新ticket 12 DELETE /tickets/12 # 刪除ticekt 12
2. HTTP GET方法HTTP GET方法,用于獲取資源,不管調用多少次接口,結果都不會改變,所以是冪等的。 GET /tickets # 獲取ticket列表 GET /tickets/12 # 查看某個具體的ticket 只是查詢數據,不會影響到資源的變化,因此我們認為它冪等。值得注意,冪等性指的是作用于結果而非資源本身。怎么理解呢?
例如,這個HTTP GET方法可能會每次得到不同的返回內容,但并不影響資源。 可能你會問有這種情況么?當然有咯。
例如,我們有一個接口獲取當前時間,我們就應該設計成 GET /service_time # 獲取服務器當前時間 它本身不會對資源本身產生影響,因此滿足冪等性。
3. HTTP POST方法HTTP POST方法是一個非冪等方法,因為調用多次,都將產生新的資源。 POST /tickets # 新建一個ticket因為它會對資源本身產生影響,每次調用都會有新的資源產生,因此不滿足冪等性。
4. HTTP PUT方法HTTP PUT方法是不是冪等的呢?
我們來看下 PUT /tickets/12 # 更新ticket 12 因為它直接把實體部分的數據替換到服務器的資源,我們多次調用它,只會產生一次影響,但是有相同結果的 HTTP 方法,所以滿足冪等性。
5. HTTP PATCH方法HTTP PATCH方法是非冪等的。HTTP POST方法和HTTP PUT方法可能比較好理解,但是HTTP PATCH方法只是更新部分資源,怎么是非冪等的呢?
因為,PATCH提供的實體則需要根據程序或其它協議的定義,解析后在服務器上執行,以此來修改服務器上的資源。換句話說,PATCH請求是會執行某個程序的,如果重復提交,程序可能執行多次,對服務器上的資源就可能造成額外的影響,這就可以解釋它為什么是非冪等的了。 可能你還不能理解這點。我們舉個例子PATCH /tickets/12 # 更新ticket 12 此時,我們服務端對方法的處理是,當調用一次方法,更新部分字段,將這條ticket記錄的操作記錄加一,這次,每次調用的資源是不是變了呢,所以它是有可能是非冪等的操作。
6. HTTP DELETE方法HTTP DELETE方法用于刪除資源,會將資源刪除。 DELETE /tickets/12 # 刪除ticekt 12 調用一次和多次對資源產生影響是相同的,所以也滿足冪等性。