70-HTTP POST 请求参数形式

简介

HTTP 协议是以 ASCII 码 传输,建立在 TCP/IP 协议之上的应用层规范。规范把 HTTP 请求分为三个部分:状态行、请求头、消息主体。

协议规定 POST 提交的数据必须放在消息主体(entity-body)中,但协议并没有规定数据必须 使用什么编码方式 。实际上,开发者完全可以自己决定消息主体的格式,只要最后发送的 HTTP 请求满足上面的格式就可以。

数据发送出去,还要服务端解析成功才有意义。一般服务端语言如 php、python 等,以及它们的 framework,都内置了自动解析常见数据格式的功能。服务端通常是根据请求头(headers)中的 Content-Type 字段来获知请求中的消息主体是用何种方式编码,再对主体进行解析。

form 表单中 enctype 属性

form 表单中 enctype 属性可以用来控制对表单数据的发送前的如何进行编码,enctype 有三种,分别为:

  • multipart/form-data 不对字符编码,用于发送二进制的文件,其他两种类型不能用于发送文件;
  • text/plain 用于发送纯文本内容,空格转换为 “+” 加号,不对特殊字符进行编码,一般用于email之类的;
  • application/x-www-form-urlencoded 在发送前会编码所有字符,即在发送到服务器之前,所有字符都会进行编码(空格转换为 “+” 加号,”+”加号转换为空格,特殊符号转换为 ASCII HEX 值)。

其中 application/x-www-form-urlencoded 为默认类型。

常见的 post 的参数请求方式

1、Content-Type: application/x-www-form-urlencoded

浏览器的原生 <form> 表单,如果不设置 enctype 属性,那么最终就会以 application/x-www-form-urlencoded 方式提交数据。

示例:

1
2
Content-Type: application/x-www-form-urlencoded;charset=utf-8
input1=xxx&input2=ooo&remember=false

大部分服务端语言都对这种方式很好的支持,常用的如 jQuery 中的 ajax 请求,Content-Type 默认值都是 application/x-www-form-urlencoded;charset=utf-8

2、Content-Type: multipart/form-data

这也是常见的 post 请求方式,一般用来上传文件,各大服务器的支持也比较好。所以我们使用表单 上传文件 时,必须让 <form> 表单的 enctype 属性值为 multipart/form-data.

注意:以上两种方式:application/x-www-form-urlencodedmultipart/form-data 都是浏览器原生支持的

3、Content-Type: application/json

application/json 以将数据序列化成一个 JSON 字符串作为请求主体。相比其他只能传输键值对的方式,这种编码方式更加灵活和简单高效。它支持复杂的嵌套结构、数组、对象等,非常适合传输包含多层级数据关系的数据。

示例:

1
2
3
4
POST http://www.example.com HTTP/1.1
Content-Type: application/json;charset=utf-8

{"name":"test", "age": 24, "hobby":["a","b","c"]}

4、Content-Type: text/xml

这个 post 发送的 data 是 xml 格式

1
2
3
4
5
6
7
8
<!--?xml version="1.0"?-->
<methodcall>
<methodname>examples.getStateName</methodname>
<params>
<param>
<value><i4>41</i4></value>
</params>
</methodcall>

postman 请求的 form-data、x-www-form-urlencoded、raw、binary 的区别

1、form-data

等价于 http 请求中的 multipart/form-data,它会将表单的数据处理为一条消息,以标签为单元,用分隔符分开。既可以上传键值对,也可以上传文件。当上传的字段是文件时,会有 Content-Type 来表名文件类型;content-disposition,用来说明字段的一些信息;

由于有 boundary 隔离,所以 multipart/form-data 既可以上传文件,也可以上传键值对,它采用了键值对的方式,所以可以上传多个文件。

2、x-www-form-urlencoded

等价于 application/x-www-from-urlencoded,会将表单内的数据转换为键值对,比如,name=java&age = 23

3、raw

可以上传任意格式的文本,可以上传text、json、xml、html等,等价与 text/plain 的 text/json/xml/html

4、binary

相当于 Content-Type:application/octet-stream,从字面意思得知,只可以上传二进制数据,通常用来上传文件,由于没有键值,所以,一次只能上传一个文件。

multipart/form-data与x-www-form-urlencoded区别

multipart/form-data:既可以上传文件等二进制数据,也可以上传表单键值对,只是最后会转化为一条信息;

x-www-form-urlencoded:只能上传键值对,并且键值对都是间隔分开的。


70-HTTP POST 请求参数形式
https://flepeng.github.io/010-network-70-应用层-70-HTTP-POST-请求参数形式/
作者
Lepeng
发布于
2021年3月8日
许可协议