常见的POST数据格式

2012-10-17 22:50:16

HTTP/1.1 规定的HTTP方法有 OPTIONS、GET、HEAD、POST、PUT、DELETE、TRACE、CONNECT 这几种。POST是常用的提交数据,并可能会对服务器数据做相关修改的方法。这里讨论 POST方法 提交数据的几种方式。


我们知道,HTTP 协议是以 ASCII 码传输,建立在 TCP/IP 协议之上的应用层规范。规范把 HTTP 请求分为三个部分:状态行、请求头、消息主体。类似于下面这样:


<method> <request-url> <version>

<headers>

<entity-body></entity-body>

</headers>

</version></request-url></method>


按照协议, POST 提交的数据必须放在消息主体(entity-body)中,但协议并没有对数据的编码方式做出规定。所以,开发者可以自己决定消息主体的格式。开发者需要将格式放在headers的Content-Type中,然后服务器端根据headers中的格式规定,按照特定的方式解析BODY中的数据。


在长期的开发过程中,开发者们形成了一些常用的数据格式,很多语言对这些常用数据格式开发了解析和分装的库。这里就总结一下常用的几种。


1. application/x-www-form-urlencoded

这应该是最常见的 POST 提交数据的方式了。浏览器的原生 form 表单,如果不设置 enctype 属性,那么最终就会以这种方式提交数据。请求类似于下面这样(无关的请求头在本文中都省略掉了):

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;其次,提交的数据按照 key1=val1&key2=val2 的方式进行编码,key 和 val 都进行了 URL 转码。大部分服务端语言都对这种方式有很好的支持。例如 PHP 中,POST[′title′]可以获取到title的值,POST[title]可以获取到title的值,_POST['sub'] 可以得到 sub 数组。

很多时候,我们用 Ajax 提交数据时,也是使用这种方式。例如 JQuery 和 QWrap 的 Ajax,Content-Type 默认值都是「application/x-www-form-urlencoded;charset=utf-8」。



2. multipart/form-data

这又是一个常见的 POST 数据提交的方式。我们使用表单上传文件时,必须让 form 的 enctyped 等于这个值。直接来看一个请求示例:

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--



这种方式一般用来上传文件,各大服务端语言对它也有着良好的支持。

上面提到的这两种 POST 数据的方式,都是浏览器原生支持的,而且现阶段原生 form 表单也只支持这两种方式。但是随着越来越多的 Web 站点,尤其是 WebApp,全部使用 Ajax 进行数据交互之后,我们完全可以定义新的数据提交方式,给开发带来更多便利。


接下来的两种数据格式,就是WEB service中常用的。


3.application/json


Google 的 AngularJS 中的 Ajax 功能,默认就是提交 JSON 字符串。例如下面这段代码:


var data = {'title':'test', 'sub' : [1,2,3]};


$http.post(url, data).success(function(result) {


...


});


最终发送的请求是:

POST http://www.example.com HTTP/1.1


Content-Type: application/json;charset=utf-8


{"title":"test","sub":[1,2,3]}


这种方案,可以方便的提交复杂的结构化数据,特别适合 RESTful 的接口。各大抓包工具如 Chrome 自带的开发者工具、Firebug、Fiddler,都会以树形结构展示 JSON 数据,非常友好。但也有些服务端语言还没有支持这种方式,例如 php 就无法通过 $_POST 对象从上面的请求中获得内容。这时候,需要自己动手处理下:在请求头中 Content-Type 为 application/json 时,从 php://input 里获得原始输入流,再 json_decode 成对象。一些 php 框架已经开始这么做了。



4.text/xml

JSON出来之前,XML是这个领域的王者。典型的 XML-RPC 请求是这样的:


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>


</params>


</methodcall>


不过,由于编码比JSON复杂,JSON在目前应用已经越来越多。

同时WEB SERVICE也逐渐由RPC架构向RESTful架构转化。