【Rest】Restful http實(shí)現(xiàn)必須小心的坑

這里說的坑八孝,都是實(shí)際項目中遇到的,記錄下來鸠项,也與讀者分享干跛。

1. Content-Length一定盡量與body長度一致

Content-Length用來標(biāo)識http請求or響應(yīng)的body的長度(即字節(jié)數(shù)),是http報文分界的一種方法祟绊。由于程序bug或者故障楼入,有可能導(dǎo)致http報文中的body長度與Content-Length不一致:

  1. http請求的body長度與其Content-Length不一致
    后果

    1. Content-Length > body長度哥捕,則服務(wù)器端卡住,只能通過超時或者關(guān)閉連接解決嘉熊;
    2. Content-Length < body長度遥赚,則連接腐爛,只能關(guān)閉連接(影響長連接效果)阐肤。
  2. http響應(yīng)的body長度與其Content-Length不一致
    后果

    1. Content-Length > body長度 客戶端卡著凫佛,只能通過超時或者關(guān)閉連接解決
    2. Content-Length < body長度 連接腐爛,只能關(guān)閉連接

這么看孕惜,Content-Length應(yīng)該是要一定與body長度一致愧薛,為什么說盡量?因為出故障時我們可能無能為力:比如我們數(shù)據(jù)庫記錄了一個文件大小為100MB诊赊,于是設(shè)置Content-Length=100MB厚满,然后把文件內(nèi)容作為body返回客戶端,但是文件已經(jīng)損壞(只有讀的時候才能發(fā)現(xiàn))碧磅,只有50M,由于http的start line和headers已經(jīng)發(fā)給了客戶端遵馆,沒法更改了鲸郊,客戶端收到50M內(nèi)容后,繼續(xù)等待接收剩下的50M货邓,直至超時或連接關(guān)閉秆撮,表現(xiàn)為客戶端卡著。

2. 參數(shù)parameter最小化

舉例: 如果我們有2個接口(來自AWS S3文檔)

設(shè)置跨域規(guī)則接口

PUT /?cors HTTP/1.1
Host: bucketname.s3.amazonaws.com

設(shè)置生命周期管理接口

PUT /?lifecycle HTTP/1.1
Host: bucketname.s3.amazonaws.com

那么服務(wù)端應(yīng)該這樣實(shí)現(xiàn):

  1. 參數(shù)只有cors -- 按照設(shè)置跨域規(guī)則來處理
  2. 參數(shù)只有l(wèi)ifecycle -- 按照設(shè)置生命周期管理來處理
  3. 否則 -- 返回400 Bad Request

不遵循的危害:影響接口擴(kuò)展

比如 如果前期服務(wù)器將/?lifecycle/?lifecycle&haha同等對待换况,那么由于Rest API是開放的以及客戶端實(shí)現(xiàn)的不確定性职辨,不好保證有的用戶發(fā)的是/?lifecycle&haha接口。如果后期服務(wù)器想加個接口/?lifecycle&haha以實(shí)現(xiàn)其他功能戈二,則因為該接口可能已被當(dāng)做/?lifecycle來對待而造成困擾舒裤。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市觉吭,隨后出現(xiàn)的幾起案子腾供,更是在濱河造成了極大的恐慌,老刑警劉巖鲜滩,帶你破解...
    沈念sama閱讀 217,185評論 6 503
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件伴鳖,死亡現(xiàn)場離奇詭異,居然都是意外死亡徙硅,警方通過查閱死者的電腦和手機(jī)榜聂,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,652評論 3 393
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來嗓蘑,“玉大人须肆,你說我怎么就攤上這事贴汪。” “怎么了休吠?”我有些...
    開封第一講書人閱讀 163,524評論 0 353
  • 文/不壞的土叔 我叫張陵扳埂,是天一觀的道長。 經(jīng)常有香客問我瘤礁,道長阳懂,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,339評論 1 293
  • 正文 為了忘掉前任柜思,我火速辦了婚禮岩调,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘赡盘。我一直安慰自己号枕,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,387評論 6 391
  • 文/花漫 我一把揭開白布陨享。 她就那樣靜靜地躺著葱淳,像睡著了一般。 火紅的嫁衣襯著肌膚如雪抛姑。 梳的紋絲不亂的頭發(fā)上赞厕,一...
    開封第一講書人閱讀 51,287評論 1 301
  • 那天,我揣著相機(jī)與錄音定硝,去河邊找鬼皿桑。 笑死,一個胖子當(dāng)著我的面吹牛蔬啡,可吹牛的內(nèi)容都是我干的诲侮。 我是一名探鬼主播,決...
    沈念sama閱讀 40,130評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼箱蟆,長吁一口氣:“原來是場噩夢啊……” “哼沟绪!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起顽腾,我...
    開封第一講書人閱讀 38,985評論 0 275
  • 序言:老撾萬榮一對情侶失蹤近零,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后抄肖,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體久信,經(jīng)...
    沈念sama閱讀 45,420評論 1 313
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,617評論 3 334
  • 正文 我和宋清朗相戀三年漓摩,在試婚紗的時候發(fā)現(xiàn)自己被綠了裙士。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 39,779評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡管毙,死狀恐怖腿椎,靈堂內(nèi)的尸體忽然破棺而出桌硫,到底是詐尸還是另有隱情,我是刑警寧澤啃炸,帶...
    沈念sama閱讀 35,477評論 5 345
  • 正文 年R本政府宣布铆隘,位于F島的核電站,受9級特大地震影響南用,放射性物質(zhì)發(fā)生泄漏膀钠。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,088評論 3 328
  • 文/蒙蒙 一裹虫、第九天 我趴在偏房一處隱蔽的房頂上張望肿嘲。 院中可真熱鬧,春花似錦筑公、人聲如沸雳窟。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,716評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽封救。三九已至,卻和暖如春耸采,著一層夾襖步出監(jiān)牢的瞬間兴泥,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 32,857評論 1 269
  • 我被黑心中介騙來泰國打工虾宇, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人如绸。 一個月前我還...
    沈念sama閱讀 47,876評論 2 370
  • 正文 我出身青樓嘱朽,卻偏偏與公主長得像,于是被迫代替她去往敵國和親怔接。 傳聞我的和親對象是個殘疾皇子搪泳,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,700評論 2 354

推薦閱讀更多精彩內(nèi)容