javascript
Http提交数据格式与Spring获取参数知识点整理
Http Content-Type
1. About
在HTTP 1.1規(guī)范中,HTTP請(qǐng)求方式有OPTIONS、GET、HEAD、POST、PUT、DELETE、TRACE、CONNECT 通常我們用的只有GET、POST,然而對(duì)于Restful API規(guī)范來(lái)說(shuō),請(qǐng)求資源要用PUT方法,刪除資源要用DELETE方法。
例如發(fā)送個(gè)DELETE包:
http://example.com/my/resource?id=12345那么通過(guò)id就能獲取到信息,這個(gè)包只有header,并不存在body,下面討論幾個(gè)包含body的發(fā)包的body傳輸格式。
2. Content-Type
Content-Type用于指定內(nèi)容類(lèi)型,一般是指網(wǎng)頁(yè)中存在的Content-Type,Content-Type屬性指定請(qǐng)求和響應(yīng)的HTTP內(nèi)容類(lèi)型。如果未指定 ContentType,默認(rèn)為text/html。
在nginx中有個(gè)配置文件mime.types,主要是標(biāo)示Content-Type的文件格式。
下面是幾個(gè)常見(jiàn)的Content-Type:
1. text/html 2. text/plain 3. text/css 4. text/javascript 5. application/x-www-form-urlencoded 6. multipart/form-data 7. application/json 8. application/xml ...前面幾個(gè)都很好理解,都是html,css,javascript的文件類(lèi)型,后面四個(gè)是POST的發(fā)包方式。
3. application/x-www-form-urlencoded
application/x-www-form-urlencoded是常用的表單發(fā)包方式,普通的表單提交,或者js發(fā)包,默認(rèn)都是通過(guò)這種方式,
比如一個(gè)簡(jiǎn)單地表單:
<form enctype="application/x-www-form-urlencoded" action="http://homeway.me/post.php" method="POST"><input type="text" name="name" value="homeway"><input type="text" name="key" value="nokey"><input type="submit" value="submit"> </form>那么服務(wù)器收到的raw header會(huì)類(lèi)似:
Accept:text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8 Accept-Encoding:gzip, deflate Accept-Language:zh-CN,zh;q=0.8,en;q=0.6,zh-TW;q=0.4,gl;q=0.2,de;q=0.2 Cache-Control:no-cache Connection:keep-alive Content-Length:17 Content-Type:application/x-www-form-urlencoded那么服務(wù)器收到的raw body會(huì)是,name=homeway&key=nokey.
4. multipart/form-data
multipart/form-data用在發(fā)送文件的POST包。 這里假設(shè)我用python的request發(fā)送一個(gè)文件給服務(wù)器:
data = {"key1": "123","key2": "456", } files = {'file': open('index.py', 'rb')} res = requests.post(url="http://localhost/upload", method="POST", data=data, files=files) print res通過(guò)工具,可以看到我發(fā)送的數(shù)據(jù)內(nèi)容如下:
POST http://www.homeway.me HTTP/1.1 Content-Type:multipart/form-data; boundary=------WebKitFormBoundaryOGkWPJsSaJCPWjZP------WebKitFormBoundaryOGkWPJsSaJCPWjZP Content-Disposition: form-data; name="key2" 456 ------WebKitFormBoundaryOGkWPJsSaJCPWjZP Content-Disposition: form-data; name="key1" 123 ------WebKitFormBoundaryOGkWPJsSaJCPWjZP Content-Disposition: form-data; name="file"; filename="index.py"這里Content-Type告訴我們,發(fā)包是以multipart/form-data格式來(lái)傳輸,另外,還有boundary用于分割數(shù)據(jù)。當(dāng)文件太長(zhǎng),HTTP無(wú)法在一個(gè)包之內(nèi)發(fā)送完畢,就需要分割數(shù)據(jù),分割成一個(gè)一個(gè)chunk發(fā)送給服務(wù)端,那么--用于區(qū)分?jǐn)?shù)據(jù)快,而后面的數(shù)據(jù)633e61ebf351484f9124d63ce76d8469就是標(biāo)示區(qū)分包作用。
四種常見(jiàn)的 POST 提交數(shù)據(jù)方式
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)求頭、消息主體。類(lèi)似于下面這樣:
<method> <request-URL> <version><headers><entity-body>協(xié)議規(guī)定 POST 提交的數(shù)據(jù)必須放在消息主體(entity-body)中,但協(xié)議并沒(méi)有規(guī)定數(shù)據(jù)必須使用什么編碼方式。實(shí)際上,開(kāi)發(fā)者完全可以自己決定消息主體的格式,只要最后發(fā)送的 HTTP 請(qǐng)求滿(mǎn)足上面的格式就可以。
但是,數(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)始介紹它們。
1. 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)求類(lèi)似于下面這樣(無(wú)關(guān)的請(qǐng)求頭在本文中都省略掉了):
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首先,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ì)這種方式有很好的支持。
很多時(shí)候,我們用 Ajax 提交數(shù)據(jù)時(shí),也是使用這種方式。例如 JQuery 和 QWrap 的 Ajax,Content-Type 默認(rèn)值都是application/x-www-form-urlencoded;charset=utf-8。
2. multipart/form-data
這又是一個(gè)常見(jiàn)的 POST 數(shù)據(jù)提交的方式。我們使用表單上傳文件時(shí),必須讓 form 的 enctyped 等于這個(gè)值。直接來(lái)看一個(gè)請(qǐng)求示例:
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--這個(gè)例子稍微復(fù)雜點(diǎn)。首先生成了一個(gè) boundary 用于分割不同的字段,為了避免與正文內(nèi)容重復(fù),boundary 很長(zhǎng)很復(fù)雜。然后 Content-Type 里指明了數(shù)據(jù)是以 mutipart/form-data 來(lái)編碼,本次請(qǐng)求的 boundary 是什么內(nèi)容。消息主體里按照字段個(gè)數(shù)又分為多個(gè)結(jié)構(gòu)類(lèi)似的部分,每部分都是以 –boundary 開(kāi)始,緊接著內(nèi)容描述信息,然后是回車(chē),最后是字段具體內(nèi)容(文本或二進(jìn)制)。如果傳輸?shù)氖俏募?#xff0c;還要包含文件名和文件類(lèi)型信息。消息主體最后以 –boundary– 標(biāo)示結(jié)束。關(guān)于 mutipart/form-data 的詳細(xì)定義,請(qǐng)前往 rfc1867 查看。
這種方式一般用來(lái)上傳文件,各大服務(wù)端語(yǔ)言對(duì)它也有著良好的支持。
上面提到的這兩種 POST 數(shù)據(jù)的方式,都是瀏覽器原生支持的,而且現(xiàn)階段原生 form 表單也只支持這兩種方式。但是隨著越來(lái)越多的 Web 站點(diǎn),尤其是 WebApp,全部使用 Ajax 進(jìn)行數(shù)據(jù)交互之后,我們完全可以定義新的數(shù)據(jù)提交方式,給開(kāi)發(fā)帶來(lái)更多便利。
3. 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 字符串。例如下面這段代碼:
var data = {'title':'test', 'sub' : [1,2,3]}; $http.post(url, data).success(function(result) {... });最終發(fā)送的請(qǐng)求是:
POST http://www.example.com HTTP/1.1 Content-Type: application/json;charset=utf-8 {"title":"test","sub":[1,2,3]}這種方案,可以方便的提交復(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ù)。如有需要,可以參考這篇文章。
4. text/xml
我的博客之前提到過(guò) XML-RPC(XML Remote Procedure Call)。它是一種使用 HTTP 作為傳輸協(xié)議,XML 作為編碼方式的遠(yuǎn)程調(diào)用規(guī)范。典型的 XML-RPC 請(qǐng)求是這樣的:
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>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ì)更靈活方便。
Spring中@RequestParam和@RequestBody區(qū)別
@RequestParam
常用來(lái)處理簡(jiǎn)單類(lèi)型的綁定,通過(guò)Request.getParameter() 獲取的String可直接轉(zhuǎn)換為簡(jiǎn)單類(lèi)型的情況( 由String到 簡(jiǎn)單類(lèi)型的轉(zhuǎn)換操作由ConversionService配置的轉(zhuǎn)換器來(lái)完成);因?yàn)槭褂胷equest.getParameter()方式獲取參數(shù),所以可以處理get 方式中queryString的值,也可以處理post方式中 body data的值。
用來(lái)處理Content-Type為application/x-www-form-urlencoded編碼的內(nèi)容,提交方式GET、POST。(不設(shè)置這個(gè)屬性,好像這就是默認(rèn)值).
該注解有兩個(gè)屬性: value、required;value用來(lái)指定要傳入值的id名稱(chēng),required用來(lái)指示參數(shù)是否必須綁定。 在方法參數(shù)里面如是:
@RequestBody
- application/x-www-form-urlencoded 可選(即非必須,因?yàn)檫@種情況的數(shù)據(jù)@RequestParam,@ModelAttribute也可以處理,當(dāng)然@RequestBody也能處理);
- multipart/form-data 不能處理(次類(lèi)型多用來(lái)上傳文件類(lèi)型---即使用@RequestBody不能處理這種格式的數(shù)據(jù),@RequestParam這個(gè)卻是可以處理的)。
- 其他格式, 必須(其他格式包括application/json,application/xml等。這些格式的數(shù)據(jù),必須使用@RequestBody來(lái)處理)。
- application/x-www-form-urlencoded, 必須;
- multipart/form-data, 不能處理;
- 其他格式, 必須;
說(shuō)明:request的body部分的數(shù)據(jù)編碼格式由header部分的Content-Type指定;
總結(jié)
- @RequestParam這個(gè)一般就是在ajax里面沒(méi)有聲明contentType的時(shí)候,為默認(rèn)的。。。urlencode格式時(shí),用這個(gè)。
- @RequestBody這個(gè)一般處理的是在ajax請(qǐng)求中聲明contentType: application/json;charset=utf-8時(shí)候。也就是json數(shù)據(jù)或者xml(我沒(méi)用過(guò)這個(gè),用的是json)
參考:
-
理解HTTP之Content-Type
-
四種常見(jiàn)的POST提交數(shù)據(jù)方式
-
@RequestParam和@RequestBody的區(qū)別-------springMVC
轉(zhuǎn)載于:https://my.oschina.net/u/1391136/blog/786725
總結(jié)
以上是生活随笔為你收集整理的Http提交数据格式与Spring获取参数知识点整理的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問(wèn)題。
- 上一篇: js 日期 加天数计算
- 下一篇: 随笔,感悟