这是关于Golang
之我想写个web
框架的第5篇文章,这篇文章主要讲述如何获取POST
请求报文提交的数据。
如果还没看过其他几篇,建议先看本专栏的另外几篇文章:
- 获取
http
请求报文: juejin.cn/post/712023… - 构建
http
响应报文: juejin.cn/post/712061… - 框架整合 : juejin.cn/post/712170…
- 获取
Get
请求提交的数据: juejin.cn/post/712728…
如何通过POST
提交数据
和GET
方法不同的时,POST
请求报文提交数据,是放在报文主体里面的,如下图黄色框框那部分,那2者有何区别呢?
GET
和POST
请求的区别
数据承载方式不同
其中最简单的区别是 GET
请求提交数据,会直接将提交的数据现实出来,而POST
请求提交数据,则不会(至少你不抓包,是看不到的),例如,我们想提交一个用户登录的请求,请求路由为 /login
,请求数据为: username="pdudo"&password="123"
,那我们使用GET
进行请求的时候,实际向服务器发送的uri
为: /login?username="pdudo"&password="123"
,这样的话,使用GET
请求来发送数据,似乎显得不太妥当,所以说,一般而言,我们需要发送数据的话,我们都会考虑POST
。
允许的数据大小不同
通过上述信息,我们了解到GET
和POST
上传的时候,数据承载方式不同,一个是放在URL
上(GET
),一个是放在报文请求主体上(POST
),那么此二者允许的数据大小则不同,前者(GET
)需要考虑的时候,URL
允许的最大长度,这个主要取决客户端允许的最大长度,而后者(POST
),则考虑的时候服务器设置允许的大小。从侧面来讲,GET
允许的长度是别人固定好了的,而POST
允许的长度则是自己在服务器设置的。
使用POST
能够提交什么类型的数据
协议并没有讲述允许使用什么类型的数据,但是提交的数据,必须要在服务器解析出来才行,下面,我们就介绍2种请求数据的类型。
这里强调一点,上传的数据需要以URL
编码方式组成,这里再介绍一下吧,URL
中除了使用英文、数字 和 特殊字符(-_.~!*
)外,其他字符,都需要编码,编码的方式为,将以%
作为开头,以示区分这是编码数据,然后将需要编码的字符,使用2位16进制表示,例如空格使用%20
来表示,例如“名字”这2个字编码后的字符为: %E5%90%8D%E5%AD%97
。
如何判断提提交类型
我们POST
可以提交的数据类型有很多,例如: x-www-form-urlencod
、json
、form-data
甚至于,你自己都可以写一个提交的类型,只要web
服务器能够判断类型且解析即可,那么我们上传类型这么多,服务器是如何知晓上传的类型的呢?
其实在上传数据的时候,也需要我们客户端指定上传的类型,我们将其写在请求头Content-Type
中,在本节后面,我们将有演示。
提交urlencoded数据
它提交数据的时候,以key=val
的形式出现,若出现多个需要上传的数据,则以&
进行连接的,例如,我们上传一个用户名和密码,则报文主体为:
username=pdudo&password=123
如上报文,则提交了2个数据:
变量名 | 值 |
username | pdudo |
password | 123 |
这里就不过多介绍了。
提交json数据
它提交数据的时候,是以json
的形式提交的,例如,我们同样提交username=pdudo&password=123
用json
的方法,则是
{ "username": "pdudo", "password": "123" }
手画一个POST
请求图
例如:
我们请求的方法为POST
,请求的路由为:/login
,上传数据格式为x-www-form-urlencod
,数据为: username=pdudo&password=123
,报文可以编写为如下:
事实真的如此么,我们可以利用curl
请求一下,顺带将其Head
打印出来即可。
命令:
curl -X POST localhost:8082/login \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "username=pdudo&password=123" -v
其中-H
是新增请求头,我们指定了Content-Type
为application/x-www-form-urlencoded
,-d
是我们提交的数据 -v
是打印详细信息出来。
代码编写
我们已经梳理了POST
提交代码的方法和报文结构,那应该如何编写代码呢? 如上所述,我们解析的内容是根据Content-Type
来的,所以我们得先要获取该请求头的数据,而后再判断其值是否是 application/x-www-form-urlencoded
或者application/json
。如果是的话,我们再根据其中判断即可。
其中注意一点,Content-Type
可能是这样的:
那也没关系,我们仅需要判断该数据,是否是以 application/x-www-form-urlencoded
开头的就可以了,我们判断代码如下:
如上代码是我们将application/x-www-form-urlencoded
和application/json
给分开了,我们虽然都传入fromBodyGetPostData
,不过还会传一个类型,前者为1,后者为2。
如上代码我们会先判断,请求主体是否为空,若为空,则退出函数,否则的话,将申请一个map
用以存放我们上传的数据,而后根据上传的类型,来获取响应的数据。
这是获取json
信息的方法。
这是获取urlencode
的方法。
功能测试
测试发送urlencoded数据
我们使用curl
进行测试。
命令:
curl -X POST -d "username=pdudo&密码=123" 127.0.0.1:8082/login -v
哎,你可能会问,这次为什么没有加-H
参数了呢,因为curl
若执行POST
请求的话,默认Content-Type
就是application/x-www-form-urlencoded
。 我的curl
版本是7.68.0
。
我们看看执行效果:
其中报文信息,我都给列出来了,你看,默认就是application/x-www-form-urlencoded
吧,我们再看看服务器日志呢。
我们通过POST
请求传递Content-Type
的数据,已经被服务器接受到了。
测试发送json数据
我们同样使用curl
进行测试。
注意,若是发送json
数据,则需要指定请求头了。
命令:
curl -X POST -d '{"username": "json_pdudo","密码": "json_123"}' \ > -H "Content-Type: application/json" \ > 127.0.0.1:8082/login -v
我们再通过服务器来看日志的话
发现服务器也接收到了。
总结
在本篇文章中,我们学习GET
和POST
请求发送数据的区别,以及了如何通过POST
提交json
和urlencoded
数据。
GET
和POST
请求发送数据的最大区别是,GET
在url
上构建数据,允许的最大长度取决于客户端,而POST
则通过添加到报文主体的方式构建数据,允许的最大长度则取决于服务器。
在利用POST
提交数据的时候,我们得声明请求头Content-Type
,它的值是存报文主体的类型,或是json
、urlencoded
以及其他类型,服务器收到请求后,需要先查看Content-Type
的值,再根据其值用不同的方法来获取数据,代码已经上传到了gitee
: gitee.com/pdudo/Sampl…。
快来动动小手试试吧。