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