來(lái)源: https://imququ.com/post/four-ways-to-post-data-in-http.html
HTTP/1.1 協(xié)議規(guī)定的 HTTP 請(qǐng)求方法有 OPTIONS哮兰、GET夭织、HEAD、POST矿咕、PUT、DELETE春锋、TRACE累贤、CONNECT 這幾種。其中 POST 一般用來(lái)向服務(wù)端提交數(shù)據(jù)屹耐,本文主要討論 POST 提交數(shù)據(jù)的幾種方式尸疆。
我們知道,HTTP 協(xié)議是以 ASCII 碼傳輸惶岭,建立在 TCP/IP 協(xié)議之上的應(yīng)用層規(guī)范寿弱。規(guī)范把 HTTP 請(qǐng)求分為三個(gè)部分:狀態(tài)行、請(qǐng)求頭按灶、消息主體症革。類似于下面這樣:
<pre style="margin: 15px 0px 0px; padding: 0.6em; font-size: 14px; line-height: 1.6; color: rgb(93, 106, 106); border-left: 5px solid rgb(204, 204, 204); background-color: rgb(248, 248, 248); word-break: break-word; overflow-wrap: break-word; white-space: pre-wrap; position: relative; overflow: hidden; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration-style: initial; text-decoration-color: initial;">BASH`<method> <request-URL> <version>
<headers>
<entity-body>` </pre>
協(xié)議規(guī)定 POST 提交的數(shù)據(jù)必須放在消息主體(entity-body)中,但協(xié)議并沒(méi)有規(guī)定數(shù)據(jù)必須使用什么編碼方式鸯旁。實(shí)際上噪矛,開(kāi)發(fā)者完全可以自己決定消息主體的格式,只要最后發(fā)送的 HTTP 請(qǐng)求滿足上面的格式就可以铺罢。
但是艇挨,數(shù)據(jù)發(fā)送出去,還要服務(wù)端解析成功才有意義韭赘。一般服務(wù)端語(yǔ)言如 php缩滨、python 等,以及它們的 framework泉瞻,都內(nèi)置了自動(dòng)解析常見(jiàn)數(shù)據(jù)格式的功能脉漏。服務(wù)端通常是根據(jù)請(qǐng)求頭(headers)中的 Content-Type 字段來(lái)獲知請(qǐng)求中的消息主體是用何種方式編碼,再對(duì)主體進(jìn)行解析袖牙。所以說(shuō)到 POST 提交數(shù)據(jù)方案侧巨,包含了 Content-Type 和消息主體編碼方式兩部分。下面就正式開(kāi)始介紹它們贼陶。
application/x-www-form-urlencoded
這應(yīng)該是最常見(jiàn)的 POST 提交數(shù)據(jù)的方式了刃泡。瀏覽器的原生 <form> 表單巧娱,如果不設(shè)置 enctype
屬性,那么最終就會(huì)以 application/x-www-form-urlencoded 方式提交數(shù)據(jù)烘贴。請(qǐng)求類似于下面這樣(無(wú)關(guān)的請(qǐng)求頭在本文中都省略掉了):
<pre style="margin: 15px 0px 0px; padding: 0.6em; font-size: 14px; line-height: 1.6; color: rgb(93, 106, 106); border-left: 5px solid rgb(204, 204, 204); background-color: rgb(248, 248, 248); word-break: break-word; overflow-wrap: break-word; white-space: pre-wrap; position: relative; overflow: hidden; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration-style: initial; text-decoration-color: initial;">BASH`POST http://www.example.com HTTP/1.1
Content-Type: application/x-www-form-urlencoded;charset=utf-8
title=test&sub%5B%5D=1&sub%5B%5D=2&sub%5B%5D=3` </pre>
首先禁添,Content-Type 被指定為 application/x-www-form-urlencoded;其次桨踪,提交的數(shù)據(jù)按照 key1=val1&key2=val2 的方式進(jìn)行編碼老翘,key 和 val 都進(jìn)行了 URL 轉(zhuǎn)碼。大部分服務(wù)端語(yǔ)言都對(duì)這種方式有很好的支持锻离。例如 PHP 中铺峭,_POST['sub'] 可以得到 sub 數(shù)組汽纠。
很多時(shí)候卫键,我們用 Ajax 提交數(shù)據(jù)時(shí),也是使用這種方式虱朵。例如 JQuery 和 QWrap 的 Ajax莉炉,Content-Type 默認(rèn)值都是「application/x-www-form-urlencoded;charset=utf-8」。
multipart/form-data
這又是一個(gè)常見(jiàn)的 POST 數(shù)據(jù)提交的方式碴犬。我們使用表單上傳文件時(shí)絮宁,必須讓 <form> 表單的 enctype
等于 multipart/form-data。直接來(lái)看一個(gè)請(qǐng)求示例:
<pre style="margin: 15px 0px 0px; padding: 0.6em; font-size: 14px; line-height: 1.6; color: rgb(93, 106, 106); border-left: 5px solid rgb(204, 204, 204); background-color: rgb(248, 248, 248); word-break: break-word; overflow-wrap: break-word; white-space: pre-wrap; position: relative; overflow: hidden; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration-style: initial; text-decoration-color: initial;">BASH`POST http://www.example.com HTTP/1.1
Content-Type:multipart/form-data; boundary=----WebKitFormBoundaryrGKCBY7qhFd3TrwA
------WebKitFormBoundaryrGKCBY7qhFd3TrwA
Content-Disposition: form-data; name="text"
title
------WebKitFormBoundaryrGKCBY7qhFd3TrwA
Content-Disposition: form-data; name="file"; filename="chrome.png"
Content-Type: image/png
PNG ... content of chrome.png ...
------WebKitFormBoundaryrGKCBY7qhFd3TrwA--` </pre>
這個(gè)例子稍微復(fù)雜點(diǎn)服协。首先生成了一個(gè) boundary 用于分割不同的字段绍昂,為了避免與正文內(nèi)容重復(fù),boundary 很長(zhǎng)很復(fù)雜偿荷。然后 Content-Type 里指明了數(shù)據(jù)是以 multipart/form-data 來(lái)編碼窘游,本次請(qǐng)求的 boundary 是什么內(nèi)容。消息主體里按照字段個(gè)數(shù)又分為多個(gè)結(jié)構(gòu)類似的部分跳纳,每部分都是以 --boundary
開(kāi)始张峰,緊接著是內(nèi)容描述信息,然后是回車棒旗,最后是字段具體內(nèi)容(文本或二進(jìn)制)。如果傳輸?shù)氖俏募萌伲€要包含文件名和文件類型信息铣揉。消息主體最后以 --boundary--
標(biāo)示結(jié)束。關(guān)于 multipart/form-data 的詳細(xì)定義餐曹,請(qǐng)前往 rfc1867 查看逛拱。
這種方式一般用來(lái)上傳文件,各大服務(wù)端語(yǔ)言對(duì)它也有著良好的支持台猴。
上面提到的這兩種 POST 數(shù)據(jù)的方式朽合,都是瀏覽器原生支持的俱两,而且現(xiàn)階段標(biāo)準(zhǔn)中原生 <form> 表單也只支持這兩種方式(通過(guò) <form> 元素的 enctype
屬性指定,默認(rèn)為 application/x-www-form-urlencoded
曹步。其實(shí) enctype
還支持 text/plain
宪彩,不過(guò)用得非常少)。
隨著越來(lái)越多的 Web 站點(diǎn)讲婚,尤其是 WebApp尿孔,全部使用 Ajax 進(jìn)行數(shù)據(jù)交互之后,我們完全可以定義新的數(shù)據(jù)提交方式筹麸,給開(kāi)發(fā)帶來(lái)更多便利活合。
application/json
application/json 這個(gè) Content-Type 作為響應(yīng)頭大家肯定不陌生。實(shí)際上物赶,現(xiàn)在越來(lái)越多的人把它作為請(qǐng)求頭白指,用來(lái)告訴服務(wù)端消息主體是序列化后的 JSON 字符串。由于 JSON 規(guī)范的流行酵紫,除了低版本 IE 之外的各大瀏覽器都原生支持 JSON.stringify告嘲,服務(wù)端語(yǔ)言也都有處理 JSON 的函數(shù),使用 JSON 不會(huì)遇上什么麻煩憨闰。
JSON 格式支持比鍵值對(duì)復(fù)雜得多的結(jié)構(gòu)化數(shù)據(jù)状蜗,這一點(diǎn)也很有用。記得我?guī)啄昵白鲆粋€(gè)項(xiàng)目時(shí)鹉动,需要提交的數(shù)據(jù)層次非常深轧坎,我就是把數(shù)據(jù) JSON 序列化之后來(lái)提交的。不過(guò)當(dāng)時(shí)我是把 JSON 字符串作為 val泽示,仍然放在鍵值對(duì)里缸血,以 x-www-form-urlencoded 方式提交。
Google 的 AngularJS 中的 Ajax 功能械筛,默認(rèn)就是提交 JSON 字符串捎泻。例如下面這段代碼:
<pre style="margin: 15px 0px 0px; padding: 0.6em; font-size: 14px; line-height: 1.6; color: rgb(93, 106, 106); border-left: 5px solid rgb(204, 204, 204); background-color: rgb(248, 248, 248); word-break: break-word; overflow-wrap: break-word; white-space: pre-wrap; position: relative; overflow: hidden; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration-style: initial; text-decoration-color: initial;">JSvar data = {'title':'test', 'sub' : [1,2,3]}; $http.post(url, data).success(function(result) { ... });
</pre>
最終發(fā)送的請(qǐng)求是:
<pre style="margin: 15px 0px 0px; padding: 0.6em; font-size: 14px; line-height: 1.6; color: rgb(93, 106, 106); border-left: 5px solid rgb(204, 204, 204); background-color: rgb(248, 248, 248); word-break: break-word; overflow-wrap: break-word; white-space: pre-wrap; position: relative; overflow: hidden; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration-style: initial; text-decoration-color: initial;">BASH`POST http://www.example.com HTTP/1.1
Content-Type: application/json;charset=utf-8
{"title":"test","sub":[1,2,3]}` </pre>
這種方案,可以方便的提交復(fù)雜的結(jié)構(gòu)化數(shù)據(jù)埋哟,特別適合 RESTful 的接口笆豁。各大抓包工具如 Chrome 自帶的開(kāi)發(fā)者工具、Firebug赤赊、Fiddler闯狱,都會(huì)以樹(shù)形結(jié)構(gòu)展示 JSON 數(shù)據(jù),非常友好抛计。但也有些服務(wù)端語(yǔ)言還沒(méi)有支持這種方式哄孤,例如 php 就無(wú)法通過(guò) $_POST 對(duì)象從上面的請(qǐng)求中獲得內(nèi)容。這時(shí)候吹截,需要自己動(dòng)手處理下:在請(qǐng)求頭中 Content-Type 為 application/json 時(shí)瘦陈,從 php://input
里獲得原始輸入流凝危,再 json_decode
成對(duì)象。一些 php 框架已經(jīng)開(kāi)始這么做了晨逝。
當(dāng)然 AngularJS 也可以配置為使用 x-www-form-urlencoded 方式提交數(shù)據(jù)蛾默。如有需要,可以參考這篇文章咏花。
text/xml
我的博客之前提到過(guò) XML-RPC(XML Remote Procedure Call)趴生。它是一種使用 HTTP 作為傳輸協(xié)議,XML 作為編碼方式的遠(yuǎn)程調(diào)用規(guī)范昏翰。典型的 XML-RPC 請(qǐng)求是這樣的:
<pre style="margin: 15px 0px 0px; padding: 0.6em; font-size: 14px; line-height: 1.6; color: rgb(93, 106, 106); border-left: 5px solid rgb(204, 204, 204); background-color: rgb(248, 248, 248); word-break: break-word; overflow-wrap: break-word; white-space: pre-wrap; position: relative; overflow: hidden; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; text-decoration-style: initial; text-decoration-color: initial;">HTML`POST http://www.example.com HTTP/1.1
Content-Type: text/xml
<?xml version="1.0"?>
<methodCall>
<methodName>examples.getStateName</methodName>
<params>
<param>
<value><i4>41</i4></value>
</param>
</params>
</methodCall>` </pre>
XML-RPC 協(xié)議簡(jiǎn)單苍匆、功能夠用,各種語(yǔ)言的實(shí)現(xiàn)都有棚菊。它的使用也很廣泛浸踩,如 WordPress 的 XML-RPC Api,搜索引擎的 ping 服務(wù)等等统求。JavaScript 中检碗,也有現(xiàn)成的庫(kù)支持以這種方式進(jìn)行數(shù)據(jù)交互,能很好的支持已有的 XML-RPC 服務(wù)码邻。不過(guò)折剃,我個(gè)人覺(jué)得 XML 結(jié)構(gòu)還是過(guò)于臃腫,一般場(chǎng)景用 JSON 會(huì)更靈活方便像屋。