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