application/json 四种常见的 POST 提交数据方式

网络 同时被 2 个专栏收录
9 篇文章 3 订阅
2 篇文章 1 订阅

application/json 四种常见的 POST 提交数据方式

转载声明:

本文系转载自以下两篇文章:

转载仅为方便学习查看,一切权利属于原作者,本人只是做了整理和排版,如果带来不便请联系我删除。

0x01 摘要

enctype 属性规定在发送到服务器之前应该如何对表单数据进行编码。
默认地,表单数据会编码为 “application/x-www-form-urlencoded”。就是说,在发送到服务器之前,所有字符都会进行编码(空格转换为 “+” 加号,特殊符号转换为 ASCII HEX 值)。

enctype可选项如下:

描述
application/x-www-form-urlencoded在发送前编码所有字符(默认)
multipart/form-data不对字符编码。在使用包含文件上传控件的表单时,必须使用该值。
application/json作为请求头告诉服务端消息主体是序列化的JSON字符串。除低版本的IE,基本都支持。
text/plain空格转换为 “+” 加号,但不对特殊字符编码。

HTTP/1.1 协议规定的 HTTP 请求方法有 OPTIONSGETHEADPOSTPUTDELETETRACECONNECT这几种。

其中 POST 一般用来向服务端提交数据,本文主要讨论 POST 提交数据的几种方式。

HTTP 协议是以 ASCII 码传输。他是建立在 TCP/IP 协议之上的应用层规范, 规定HTTP 请求分为三个部分:

  • 状态行
  • headers 请求头
  • entity-body 消息主体

类似于下面这样:

<method> <request-URL> <version>
<headers>

<entity-body>

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

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

0x02 application/x-www-form-urlencoded

2.1 简介

HTTP中默认的提交数据的方式。

浏览器的原生 <form>表单,如果不设置 enctype 属性,那么最终就会以 application/x-www-form-urlencoded 方式提交数据。请求类似于下面这样(无关的请求头在本文中都省略掉了):

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 转码。大部分服务端语言都对这种方式有很好的支持。

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

2.2 Spring中设置-@RequestParam

Spring中可用@RequestParam(非必须,也可以不加)来处理Content-Typeapplication/x-www-form-urlencoded数据,修饰的对象可以是基本数据类型和自定义对象。

@RequestParam的原理是SpringRequest.getParameter()中的Key-Value参数Map转化成了参数@RequestParam修饰的基本类型数据或对象。

@RequestParam同时适用于get和post,只要Content-Typeapplication/x-www-form-urlencoded

@RequestParam可使用required属性来指定某个字段是否必须有值。

@RequestParam可使用value属性来绑定原始请求参数名,后面跟本方法里字段名,如@RequestParam(required = false, value = "user")String username就是把user请求参数映射到我们定义的username,方便使用。

注意:使用@RequestBody接受的参数是不会被Servlet转化统一放在request对象的Param参数集中

2.3 Spring不加@RequestParam

在不需要时,也可不使用@RequestParam,仅在方法内定义对应字段名,如

@RequestMapping(value = "/adhoc/explainSqlV12", produces ="application/json; charset=utf-8")
@ResponseBody
 public Map<String,Object> adhocExplainSqlV12(String user,
                                             String query,
                                             String cluster,
                                             String token)

此时仍能读到这些请求参数的值,具体原理可参考关于SpringMvc使用时,不加@RequestParam注解,根据方法形参名也可以获取请求值的分析

2.4 Servlet-HttpServletRequest

也可以直接使用HttpServletRequest来获取参数

@RequestMapping(value = "/adhoc/explainSqlV42", produces ="application/json; charset=utf-8")
@ResponseBody
 public Map<String,Object> adhocExplainSqlV42(HttpServletRequest request,
                                             HttpServletResponse response) {
     Map<String, Object> result = new HashMap<>();
     try {
         String user = ServletRequestUtils.getStringParameter(request, "user");
         String query = request.getParameter("query");
         String cluster = request.getParameter("cluster");
         logger.info("user={}, query={}, cluster={}", user, query, cluster);
     } catch (ServletRequestBindingException e) {
         e.printStackTrace();
     }
     return result;
 }

0x03 multipart/form-data

3.1 简介

一个常见的 POST 数据提交的方式。我们使用表单上传文件时,必须将 的 enctype设为 multipart/form-data

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

3.2 Spring中设置

可以使用@RequestPart处理接收到的文件。

示例如下:

/**
     * 单文件上传
     * @param file
     * @param bucket
     * @return
     */
    @RequestMapping("uploadFile")
    public JsonResult uploadFile(@RequestPart("file") MultipartFile file, @RequestParam String bucket){

        String fileUrl = aliossService.uploadFile(file, bucket);
        Map<String,String> result = new HashMap<>();
        result.put("fileUrl",fileUrl);

        return success(result);
    }

0x04 application/json

4.1 简介

application/json作为请求头,用来告诉服务端消息主体是序列化的JSON字符串,除了低版本的IE,基本都支持。服务端有处理JSON的函数,使用不会有任何麻烦。

Google 的 AngularJS 中的 Ajax 功能,默认就是application/json。例如下面这段代码:

JSvar data = {'title':'test', 'sub' : [1,2,3]};
$http.post(url, data).success(function(result) {
    ...
});

最终发送的请求是:

BASHPOST http://www.example.com HTTP/1.1 
Content-Type: application/json;charset=utf-8

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

4.2 Spring中设置-@RequestBody

4.2.1 原理

  • GET请求中,因为没有HttpEntity,所以@RequestBody并不适用。
  • POST请求中,通过HttpEntity传递的参数,必须要在请求头中声明数据的类型Content-TypeSpringMVC通过使用HandlerAdapter 配置的HttpMessageConverters来解析HttpEntity中的数据,然后绑定到@RequestBody修饰的对象上。
  • @RequestBody 也可以处理 application/xml
  • @RequestBody可以和@RequestParam联合使用,但是不建议这么做,具体做法可以点这里

4.2.2 示例

在springMVC中,可以用以下方式指定参数的格式为application/json

  • 接收
    注意接收时必须用@RequestBody来修饰接收到的post body内的对象。
@RequestMapping(value = "/kill_query", method = RequestMethod.POST, consumes = "application/json; charset=utf-8")
    public ResponseEntity<String> killQuery(@RequestBody User user){} 
  • 发送
@RequestMapping(value = "/user/{userId}", method = RequestMethod.GET, produces="application/json")  
@ResponseBody  
public User getUser(@PathVariable String UserId, Model model) {}  

4.3 小结

application/json 可以方便的提交复杂的结构化数据,特别适合 RESTFul 的接口。各大抓包工具如 Chrome 自带的开发者工具、Firebug、Fiddler,都会以树形结构展示 JSON 数据,非常友好。

0x05 text/xml

我的博客之前提到过 XML-RPC(XML Remote Procedure Call)。它是一种使用 HTTP 作为传输协议,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>
        </param>
    </params>
</methodCall>

XML-RPC 协议简单、功能够用,各种语言的实现都有。它的使用也很广泛,如 WordPress 的 XML-RPC Api,搜索引擎的 ping 服务等等。JavaScript 中,也有现成的库支持以这种方式进行数据交互,能很好的支持已有的 XML-RPC 服务。不过,我个人觉得 XML 结构还是过于臃肿,一般场景用 JSON 会更灵活方便。

0xFF 参考文档

四种常见的 POST 提交数据方式
四种常见的 POST 提交数据方式+整理postman

关于更多信息,可以查看这篇文章:Http请求中Content-Type讲解以及在Spring MVC注解中produce和consumes配置详解

©️2021 CSDN 皮肤主题: 精致技术 设计师:CSDN官方博客 返回首页
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值