接口的冪等性

Idempotence is the property of certain operations in mathematics and computer science whereby they can be applied multiple times without changing the result beyond the initial application. The concept of idempotence arises in a number of places in abstract algebra (in particular, in the theory of projectors and closure operators) and functional programming (in which it is connected to the property of referential transparency).
https://en.wikipedia.org/wiki/Idempotence

以上是 冪 等性的定義逼侦,大概意思是:在數(shù)學和計算機服務中垃喊,對于 某種操作執(zhí)行多次室埋,結果 相同悔耘。

接口為什么需要冪等性诫惭?

在計算機中驮宴,由于網(wǎng)絡抖動沛简,臨時故障,服務調用失敗避免不了贪壳,尤其是分布式系統(tǒng)中迂曲,接口調用失敗更為常見,接口的冪等設計尤其更為重要寥袭。

Rest 中方法中的冪等性

  • GET: 獲取資源,不對資源更新关霸,屬于冪等传黄。
  • DELETE: 刪除資源,由于在URI上指定了要刪除資源队寇,一次和多次的結果肯定相同膘掰,屬于冪等。
  • POST 和PUT的冪等?

POST
The POST method requests that the server accept the entity enclosed in the request as a new subordinate of the web resource identified by the URI. The data POSTed might be, for example, an annotation for existing resources; a message for a bulletin board, newsgroup, mailing list, or comment thread; a block of data that is the result of submitting a web form to a data-handling process; or an item to add to a database.
PUT
The PUT method requests that the enclosed entity be stored under the supplied URI. If the URI refers to an already existing resource, it is modified; if the URI does not point to an existing resource, then the server can create the resource with that URI.

從HTTP 對POST和PUT的定義看出识埋,POST是創(chuàng)建資源凡伊,PUT既可以創(chuàng)建也可以更新資源。
那Rest 中的POST和PUT應該這樣使用:

  • POST URI: POST每次都創(chuàng)建新資源窒舟,應該不是冪等的系忙。
POST URI:
?http://www.xxx.com/orders
?http://www.xxx.com/orders/1
  • PUT: PUT方法如果資源存在,就更新惠豺,如果不存在就創(chuàng)建 指定的資源银还,所以PUT是冪等的。
PUT URI:
http://www.xxx.com/orders/1
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末洁墙,一起剝皮案震驚了整個濱河市蛹疯,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌热监,老刑警劉巖捺弦,帶你破解...
    沈念sama閱讀 222,681評論 6 517
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異孝扛,居然都是意外死亡列吼,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 95,205評論 3 399
  • 文/潘曉璐 我一進店門疗琉,熙熙樓的掌柜王于貴愁眉苦臉地迎上來冈欢,“玉大人,你說我怎么就攤上這事盈简〈粘埽” “怎么了?”我有些...
    開封第一講書人閱讀 169,421評論 0 362
  • 文/不壞的土叔 我叫張陵柠贤,是天一觀的道長香浩。 經(jīng)常有香客問我,道長臼勉,這世上最難降的妖魔是什么邻吭? 我笑而不...
    開封第一講書人閱讀 60,114評論 1 300
  • 正文 為了忘掉前任,我火速辦了婚禮宴霸,結果婚禮上囱晴,老公的妹妹穿的比我還像新娘。我一直安慰自己瓢谢,他們只是感情好畸写,可當我...
    茶點故事閱讀 69,116評論 6 398
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著氓扛,像睡著了一般枯芬。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 52,713評論 1 312
  • 那天千所,我揣著相機與錄音狂魔,去河邊找鬼。 笑死淫痰,一個胖子當著我的面吹牛最楷,可吹牛的內容都是我干的。 我是一名探鬼主播黑界,決...
    沈念sama閱讀 41,170評論 3 422
  • 文/蒼蘭香墨 我猛地睜開眼管嬉,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了朗鸠?” 一聲冷哼從身側響起蚯撩,我...
    開封第一講書人閱讀 40,116評論 0 277
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎烛占,沒想到半個月后胎挎,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 46,651評論 1 320
  • 正文 獨居荒郊野嶺守林人離奇死亡忆家,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 38,714評論 3 342
  • 正文 我和宋清朗相戀三年犹菇,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片芽卿。...
    茶點故事閱讀 40,865評論 1 353
  • 序言:一個原本活蹦亂跳的男人離奇死亡揭芍,死狀恐怖,靈堂內的尸體忽然破棺而出卸例,到底是詐尸還是另有隱情称杨,我是刑警寧澤,帶...
    沈念sama閱讀 36,527評論 5 351
  • 正文 年R本政府宣布筷转,位于F島的核電站姑原,受9級特大地震影響,放射性物質發(fā)生泄漏呜舒。R本人自食惡果不足惜锭汛,卻給世界環(huán)境...
    茶點故事閱讀 42,211評論 3 336
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望袭蝗。 院中可真熱鬧唤殴,春花似錦、人聲如沸到腥。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,699評論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽左电。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間篓足,已是汗流浹背段誊。 一陣腳步聲響...
    開封第一講書人閱讀 33,814評論 1 274
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留栈拖,地道東北人连舍。 一個月前我還...
    沈念sama閱讀 49,299評論 3 379
  • 正文 我出身青樓,卻偏偏與公主長得像涩哟,于是被迫代替她去往敵國和親索赏。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 45,870評論 2 361

推薦閱讀更多精彩內容

  • rljs by sennchi Timeline of History Part One The Cognitiv...
    sennchi閱讀 7,350評論 0 10
  • 去年11月贴彼,自己報名的心理咨詢師要在武漢考潜腻,所以規(guī)劃了這次之行,湖北其實早在讀大學時器仗,我和他借了兩輛自行車...
    兔子拈花閱讀 169評論 0 0
  • 我是你千百年前放生的白狐 千年前之恩 千年后來報 你看衣袂飄飄衣袂飄飄 夜深人靜可有人看見我在跳舞 海誓山盟都化做...
    6b2740ac93e8閱讀 247評論 0 0
  • 畢業(yè)季融涣,我家也有小學生了,一個小學精钮,一個幼兒園威鹿,這下白天至少家里安靜了。
    高揚老師閱讀 221評論 0 0
  • 最近糾結于朋友的關系轨香。我記憶中完美的人忽你,不過因為接觸較少。那些活生生臂容,有血有肉的科雳,吵過架,撒過潑的策橘,才是我一直...
    岢嵐xd閱讀 243評論 0 1