form-data和x-www-form-urlencoded的区别和延伸

这篇具有很好参考价值的文章主要介绍了form-data和x-www-form-urlencoded的区别和延伸。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

一、前言

form-data和x-www-form-urlencoded,它们完整的表示是multipart/form-data和application/x-www-form-urlencoded。

为了方便,我们下面就用form-data和x-www-form-urlencoded表示。

两者的区别,可谓是老生常谈,随便百度一下,也是有大堆资料。可是我还想用一篇文章来总结一下,主要有两点原因:

  1. form-data和x-www-form-urlencoded虽然是基础,但却很重要。而且最近在工作中,恰好遇到了这方便的坑。经过一番研究,有了新的体悟,所以想要总结一下。
  2. 文章内容不只是比较两个的区别,还会引申到HttpServletRequest,以及流不可重复读等问题,帮助大家把相关的知识串起来。

好了,闲话少叙,我们进入正题。

二、form-data和x-www-form-urlencoded区别

form-data 和 x-www-form-urlencoded 都是表单请求的一种格式,主要区别有两点。

编码方式不同

我们先说x-www-form-urlencoded,它的编码方式就隐藏在名字里:urlencoded。看到这个关键词,你想到了什么?

没错,就是js中的encodeURI函数,这个函数的功能,我相信大家并不陌生,我们就不在赘述了。

x-www-form-urlencoded就可以理解为被encodeURI编码过的querystring。

比如,我们用x-www-form-urlencoded提交如下内容:

name: 张三
age: 18

实际上,请求体会被编码成如下格式:

name=%E5%BC%A0%E4%B8%89&age=18

这里需要强调一下,urlencoded这种格式并不是json格式,因此不能使用json库将其转成json。

接下里,我们来讲form-data,完整的表示为multipart/form-data。

multipart/form-data这种格式,会把表单内容分成多个部分,这也就是multipart的含义。

比如,同样是上面的表单内容,使用multipart/form-data格式,请求体将会类似下面这样:

--AaB03x

Content-Disposition: form-data; name="name"

Content-Type: text/plain

张三

--AaB03x

Content-Disposition: form-data; name="age"

Content-Type: text/plain

18

--AaB03x--

接下来,我们详细说一下其中的细节。

  • --AaB03x,boundary,也就是边界,它就是分割表单不同part的分界线。AaB03x是一个随机字符串,需要保证整个请求体都是用相同的boundary。
  • name="name"和name="age",这个很容易理解,就是每个part的名字,也就是字段名。
  • Content-Type,每个part的内容类型,我们这里因为传的是普通文本,所以内容类型使用text/plain。
  • --boundary表示一个part的开始,--boundary--表示所有part都结束了。

除了上面的请求体,我们的请求头需要向下面这样设置:

Content-Type: multipart/form-data; boundary=AaB03x

这里关键的部分就是boundary=AaB03x,定义分界线的随机数是什么,请求体中使用的随机数,需要和请求头中定义的随机数一致。

好了,这两种编码方式的基本格式,我们已经讲完了,你的第一感觉是什么,是不是觉得multipart/form-data的格式,要比x-www-form-urlencoded复杂的多。

没错,这正x-www-form-urlencoded的一大优点——对于普通的文本内容,x-www-form-urlencoded占用的字节更少。

支持的内容类型不同

x-www-form-urlencoded只支持普通的文本内容,而multipart/form-data的每一个part部分,都支持不同的Content-Type,比如图片、音频、视频等。

比如,我们向表单里面添加一个图片:

--AaB03x

Content-Disposition: form-data; name="name"

Content-Type: text/plain

张三

--AaB03x

Content-Disposition: form-data; name="age"

Content-Type: text/plain

18

--AaB03x

Content-Disposition: form-data; name="age"; filename="test.jpg"

Content-Type: image/jpeg

xxxxxxxx

--AaB03x--

和普通的文本内容不同的是,我们增加一个filename参数,来表示文件名称;并且把Content-Type设置成image/jpeg,表明它的格式是图片。

而且,你肯定也意识到了,multipart/form-data也不是json格式,也不能用json库读取它。

接下来,我们简单总结一下两者区别。

  • x-www-form-urlencoded,一种轻型表单,只支持普通文本,优点是占用字节少。
  • multipart/form-data,会把内容分成多个部分,每个部分都支持不同的格式,优点是支持文件上传,缺点是占用字节多。

三、HttpServeltRequest的getParameter

上面,我们已经把multipart/form-data和x-www-form-urlencoded的基本区别,给大家讲明白了。

接下来,我们来延伸一个内容,就是HttpServletRequest的getParameter——这个我们几乎每天都会接触到的方法。

我之前一直以为,getParameter方法只能获取请求地址上的参数,比如:

/api/user?name=张三&age=18

直到最近,我才发现事情远没有这么简单。这也是我为什么要单独给大家引申这块内容的原因。

实际上,getParameter除了能获取请求地址上的参数,还能获取表单中的参数,包括x-www-form-urlencoded和form-data这两种格式。

不知道,你有没有好奇过,为什么getParameterMap返回的是Map<String, String[]>格式,除了请求地址上可能传数组的情况,比如:

/api/user?name=张三&age=18&age=20

另外一个重要的原因,就是同一个参数名,除了可以出现在url地址上,还可以出现在请求体中,比如下面的post请求:

/api/user?name=张三&age=18

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

age=20&gender=male

此时age就有两个值,所以返回的是数组,只是getParameter方法默认只返回数组的第一个元素而已。

public String getParameter(String name ) {
    handleQueryParameters();
    ArrayList<String> values = paramHashValues.get(name);
    if (values != null) {
        if(values.size() == 0) {
            return "";
        }
        return values.get(0);
    } else {
        return null;
    }
}

至此,你有没有发现什么细思极恐的事情。在之前我一直排斥使用getParameterMap方法,原因就是我讨厌处理数组。

相反,我更情愿使用getParameter。但现在看来,这种便利可能给我的代码带来bug——因为getParameter并不兼容参数传数组的情况。

当然,并不是说getParameter不能用,而是在用之前需要问下自己,这个参数是不是只会传单个值。

这里还能总结一个经验:如果可以,不要用HttpServletRequest接收参数,更好的做法是将请求参数封装成一个类。

比如:

@Data
public class UserDTO {
    private String name;
    private List<Integer> age;
}

一方面,数据类型能够传达更多的信息,告诉我们这个参数可能传递一个数组;另一方便,Spring的data-binder能帮我处理好一切。

虽然,getParameter可以获取x-www-form-urlencoded和form-data中参数,但是它们还是有一些细微差别。

  • x-www-form-urlencoded:所有的参数都能被获取
  • multipart/form-data:不能读取带有filename标记的内容
private void parseRequest(HttpServletRequest request) {
   try {
      Collection<Part> parts = request.getParts();
      this.multipartParameterNames = new LinkedHashSet<>(parts.size());
      MultiValueMap<String, MultipartFile> files = new LinkedMultiValueMap<>(parts.size());
      for (Part part : parts) {
         String headerValue = part.getHeader(HttpHeaders.CONTENT_DISPOSITION);
         ContentDisposition disposition = ContentDisposition.parse(headerValue);
         String filename = disposition.getFilename();
         if (filename != null) {
            if (filename.startsWith("=?") && filename.endsWith("?=")) {
               filename = MimeDelegate.decode(filename);
            }
            files.add(part.getName(), new StandardMultipartFile(part, filename));
         }
         else {
             // 只有filename为空part,才会放到multipartParameterNames里面
            this.multipartParameterNames.add(part.getName());
         }
      }
      setMultipartFiles(files);
   }
   catch (Throwable ex) {
      handleParseFailure(ex);
   }
}

你是不是还好奇,getParameter取数组的第一个元素,到底是请求体中的参数,还是url地址上的参数呢。

在写这篇文章时,我本打算介绍一下这个细节。但是后来,理智告诉我放弃传播这种无用的知识,因为它并不能指导我们写出更好的代码。相反可能会将我们引入错误的方向,比如下面的代码:

Map<String, String[]> parameterMap = request.getParameterMap();
if (parameterMap.containsKey("age") && parameterMap.get("age").length > 1) {
    String age = parameterMap.get("age")[1];
}

你知道它想表达什么吗?

好了,这一节的内容细节有点多,如果你读起来有点吃力,建议多读几遍。

四、流不可重复读

流不可重复读的问题,相信你一定遇到过。不过,你可能会疑问:我们今天讲的内容,跟这个问题有什么关系呢?

你别说,还真有,我最近就被这个问题坑了!

最近,我在工作中要开发一个接口代理的工具,需要对请求体进行一些处理。当我测试x-www-form-urlencode格式时,死活获取不到请求体。通过debug才发现,原来是getParameter搞的鬼。

相信通过前面的介绍,你已经知道原因:对于form-data和x-www-form-urlencoded这两种格式,getParameter方法会从请求体中查询参数,既然是请求体,当然会读取InputStream,从而导致后续再读取流的时候获取不到任何内容。

这个问题的一般解法,相信你已经知道了,就是写一个Filter对HttpServletRequest包装,读取InputStream中的数据,并缓存到一个byte[]中。包装类重写getInputStream方法返回一个ByteArrayInputStream,从而解决流不同重复读的问题。

上面的解法,网上的资料一搜一大堆,我就不贴代码了。

我今天要给你介绍的是另外一种思路,这种思路只能部分解决由于getParameter或getParameterMap导致的流读取的问题。

这里的部分解决,指的是如果你只是希望获取请求地址上的参数,那么这个方法能够奏效——它不会读取IO流。

这里的思路就是解析querystring。

可以通过request.getQueryString方法获取查询字符串,接下来的关键,就是如何方便的处理它。

推荐两个工具类,第一个是UriComponentsBuilder:

String queryString = request.getQueryString();

MultiValueMap<String, String> queryParams = UriComponentsBuilder.fromUriString("?" + queryString)
        .build()
        .getQueryParams();

这个类是Spring提供的,对于SpringBoot用户来说,开箱即用。

第二个是URLEncodedUtils:

String queryString = request.getQueryString();

List<NameValuePair> nameValuePairs = URLEncodedUtils.parse(queryString, StandardCharsets.UTF_8);

Map<String, List<String>> queryParams = nameValuePairs.stream()
        .collect(Collectors.groupingBy(NameValuePair::getName))
        .entrySet().stream()
        .collect(Collectors.toMap(Map.Entry::getKey, e -> e.getValue().stream()
        .map(NameValuePair::getValue).collect(Collectors.toList())));

这个类是httpclient提供的工具类,需要引入maven包:

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>${version}</version>
</dependency>

这两个工具类,能很好的帮助我们处理querystring,别再傻傻的用split函数分割了。

五、总结

“温故而知新,可以为师矣”。

这篇文章从form-data和x-www-form-urlencoded的区别为起点,一步步展开,介绍了HttpServletRequest的getParameter方法,及其导致的流不可重复读的问题。

相信再遇到的类似的问题,你应该能游刃有余了。文章来源地址https://www.toymoban.com/news/detail-529819.html

到了这里,关于form-data和x-www-form-urlencoded的区别和延伸的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • 实例教程:使用SpringBoot接收form-data和x-www-form-urlencoded数据

    【辰兮要努力】:hello你好我是辰兮,很高兴你能来阅读,昵称是希望自己能不断精进,向着优秀程序员前行! 博客来源于项目以及编程中遇到的问题总结,偶尔会有读书分享,我会陆续更新Java前端、后台、数据库、项目案例等相关知识点总结,感谢你的阅读和关注,希望我

    2024年02月19日
    浏览(38)
  • asp.net core webapi接收application/x-www-form-urlencoded和form-data参数

    框架:asp.net core webapi asp.net core webapi接收参数,请求变量设置 Post ([FromForm]TokenRequestInput user) 可以接收发送类型为multipart/form-data、application/x-www-form-urlencoded的数据 请求地址 http://localhost:5170/api/User/GetToken?code=22222 IFormFile file这个参数是接收文件,mimeType=multipart/form-data 参数use

    2024年04月15日
    浏览(38)
  • 前端数据格式解析 json,form(application/json、application/x-www-form-urlencoded、multipart/form-data)

    这几天编写web前端时,在处理前端数据发回后端时遇到了一些数据格式的问题,查了不少资料后准备整理总结一下。 常见的有两种格式 json与form json,全称是javascript object notation,即JavaScript对象标记法 json,一种轻量级(Light-Meight)、基于文本的(Text-Based)、可读的(Human-

    2024年02月03日
    浏览(64)
  • application/x-www-form-urlencoded

    在请求中,有一种数据传输的 Content-Type 是 application/x-www-form-urlencoded 。 这种数据格式的接口,在发送请求时,与我们习惯的 application/json 的形式不一样。这半个月,有个地方没理解透,被坑了很长时间。接口是通的,按接口的要求,把数据传输过去,收到的结果始终是处理

    2024年02月11日
    浏览(35)
  • x-www-form-urlencoded接收方式代码示例

    数据回推方式是 “x-www-form-urlencoded”,可以选择使用 GET 或 POST 方法来接收数据回推。 使用 GET 方法接收数据回推时,您可以将数据作为查询参数附加在请求的 URL 中。例如: http://example.com/callback?param1=value1param2=value2 在服务器端,可以使用相应的框架或库从请求的查询参数中

    2024年01月19日
    浏览(49)
  • Vue给接口传x-www-form-urlencoded类型参数

    今天在前端调用后端接口的时候出现了很多问题,出现问题的原因是跟后端没有及时的去沟通,自己一个人参考swagger接口文档闷头苦干。结果接口一直报400XSS参数攻击异常,没办法跟后端对接后才成功调用接口。 如何给接口传x-www-form-urlencoded类型的参数呢??? 参考一下代

    2024年02月13日
    浏览(38)
  • java restful application/x-www-form-urlencoded 传递参数

            在发送短信的时候,要使用x-www-form-urlencoded的编码格式进行传递参数。  具体要求: 参数名称 说明 备注 userId 用户名 timespan 时间戳 格式为yyyyMMddHHmmss password 密码 此处用原始密码+时间戳 做MD5加密,32位大写格式   phone 手机号 多个用英文逗号隔开 msgType 编码类型 选

    2024年02月14日
    浏览(41)
  • java实现postman为x-www-form-urlencoded的调用

    1.客户端实现 导入http-client jar。 2.服务端实现

    2024年02月11日
    浏览(41)
  • SAP 调取http的x-www-form-urlencoded形式的接口

    一、了解下x-www-form-urlencoded形式对于SAP来说有啥区别 简单来说, 1.raw格式就是标准的json格式:{“Name”:“John Smith”,“Age”: 23} 2.x-www格式是要转化一下的:Name=John+SmithAge=23 字段与字段相互连接要用 符号,空格用 + 连接。所以说当你的关键参数里面带有这些特殊符号时,就

    2024年02月04日
    浏览(41)
  • Qt网络编程post请求,数据格式为json或x-www-form-urlencoded

    目录 Qt网络编程post请求,数据格式为json或x-www-form-urlencoded 一、.H文件 1、.h头文件 2、.h主代码 二、.CPP文件 1、主代码  三、响应信息 返回结果(Josn数据格式输出) 四、Post数据格式参数及数据类型定义 1、Post:application/x-www-form-urlencoded数据类型格式 2、Post:application/json数据

    2024年02月07日
    浏览(42)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包