HTTP請求方法及冪等性探究

一、HTTP請求方法


根據HTTP標準,HTTP請求可以使用多種請求方式。
GET POST HEAD OPTIONS PUT PATCH DELETE TRACE CONNECT

index method description
1 GET 請求指定頁面信息,并返回實體主體
2 HEAD 類似于GET請求,只不過返回的響應中沒有具體的內容,用于獲取報頭
3 POST 向指定資源提交數據進行處理請求(例如提交表單或者上傳文件)。數據被包含在請求體中。POST請求可能會導致新的資源的建立和/或已有資源的修改。
4 PUT 從客戶端向服務器傳送的數據取代指定的文檔的內容。(全部取代)
5 PATCH 從客戶端向服務器傳送的數據取代指定的文檔的內容。(部分取代)
6 DELETE 請求服務器刪除指定的頁面。
7 CONNECT HTTP/1.1協議中預留給能夠將連接改為管道方式的代理服務器。
8 OPTIONS 允許客戶端查看服務器的性能。
9 TRACE 回顯服務器收到的請求,主要用于測試或診斷。

說完了HTTP請求方法的大致介紹,我們一起來理解一下什么是HTTP請求方法的冪等性。

二、冪等性


HTTP冪等方法,是指無論調用這個url多少次,都不會有不同的結果的HTTP方法。也就是不管你調用1次還是調用100次,1000次,結果都是一樣的(前提是服務器端的數據沒有被人為手動更改。比如說,你數據庫中的數據被手動更改過,那兩次調用的結果肯定是變化的)。

我們下面就探討一下 GET POST PUT PATCH DELETE 的冪等性。

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


HTTP GET方法

HTTP GET方法,用于獲取資源,不管調用多少次接口,結果都不會改變,所以是冪等的。

GET /tickets # 獲取ticket列表
GET /tickets/12 # 查看某個具體的ticket

只是查詢數據,不會影響到資源的變化,因此我們認為它冪等。
值得注意,冪等性指的是作用于結果而非資源本身。怎么理解呢?例如,這個HTTP GET方法可能會每次得到不同的返回內容,但并不影響資源。
可能你會問有這種情況么?當然有咯。例如,我們有一個接口獲取當前時間,我們就應該設計成

GET /service_time # 獲取服務器當前時間

它本身不會對資源本身產生影響,因此滿足冪等性。


HTTP POST方法

HTTP POST方法是一個非冪等方法,因為調用多次,都將產生新的資源

POST /tickets # 新建一個ticket

因為它會對資源本身產生影響,每次調用都會有新的資源產生,因此不滿足冪等性。


HTTP PUT方法

HTTP PUT方法是不是冪等的呢?我們來看下

PUT /tickets/12 # 更新ticket 12

因為它直接把實體部分的數據替換到服務器的資源,我們多次調用它,只會產生一次影響,但是有相同結果的 HTTP 方法,所以滿足冪等性。


HTTP PATCH方法

HTTP PATCH方法是非冪等的。HTTP POST方法和HTTP PUT方法可能比較好理解,但是HTTP PATCH方法只是更新部分資源,怎么是非冪等的呢?
因為,PATCH提供的實體則需要根據程序或其它協議的定義,解析后在服務器上執行,以此來修改服務器上的資源。換句話說,PATCH請求是會執行某個程序的,如果重復提交,程序可能執行多次,對服務器上的資源就可能造成額外的影響,這就可以解釋它為什么是非冪等的了。
可能你還不能理解這點。我們舉個例子

PATCH /tickets/12 # 更新ticket 12

此時,我們服務端對方法的處理是,當調用一次方法,更新部分字段,將這條ticket記錄的操作記錄加一,這次,每次調用的資源是不是變了呢,所以它是有可能是非冪等的操作。


HTTP DELETE方法

HTTP DELETE方法用于刪除資源,會將資源刪除。

DELETE /tickets/12 # 刪除ticekt 12

調用一次和多次對資源產生影響是相同的,所以也滿足冪等性。


三、如何設計符合冪等性的高質量RESTful API

HTTP GET方法 vs HTTP POST方法

也許,你會想起一個面試題。HTTP請求的GET與POST方式有什么區別?你可能會回答到:GET方式通過URL提交數據,數據在URL中可以看到;POST方式,數據放置在HTML HEADER內提交。但是,我們現在從RESTful的資源角度來看待問題,HTTP GET方法是冪等的,所以它適合作為查詢操作,HTTP POST方法是非冪等的,所以用來表示新增操作。
但是,也有例外,我們有的時候可能需要把查詢方法改造成HTTP POST方法。比如,超長(1k)的GET URL使用POST方法來替代,因為GET受到URL長度的限制。雖然,它不符合冪等性,但是它是一種折中的方案。

HTTP POST方法 vs HTTP PUT方法

對于HTTP POST方法和TTP PUT方法,我們一般的理解是POST表示創建資源,PUT表示更新資源。當然,這個是正確的理解。
但是,實際上,兩個方法都用于創建資源,更為本質的差別是在冪等性。HTTP POST方法是非冪等,所以用來表示創建資源,HTTP PUT方法是冪等的,因此表示更新資源更加貼切。

HTTP PUT方法 vs HTTP PATCH方法

此時,你看會有另外一個問題。HTTP PUT方法和HTTP PATCH方法,都是用來表述更新資源,它們之間有什么區別呢?我們一般的理解是PUT表示更新全部資源,PATCH表示更新部分資源。首先,這個是我們遵守的第一準則。根據上面的描述,PATCH方法是非冪等的,因此我們在設計我們服務端的RESTful API的時候,也需要考慮。如果,我們想要明確的告訴調用者我們的資源是冪等的,我的設計更傾向于使用HTTP PUT方法。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,106評論 6 542
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,441評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,211評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,736評論 1 317
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,475評論 6 412
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,834評論 1 328
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,829評論 3 446
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 43,009評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,559評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,306評論 3 358
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,516評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,038評論 5 363
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,728評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,132評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,443評論 1 295
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,249評論 3 399
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,484評論 2 379

推薦閱讀更多精彩內容