Spring之RequestBody的使用

Spring之RequestBody的使用姿势小结
SpringMVC中处理请求参数有好几种不同的方式，如我们常见的下面几种

根据 HttpServletRequest 对象获取
根据 @PathVariable 注解获取url参数
根据 @RequestParam 注解获取请求参数
根据Bean的方式获取请求参数
根据 @ModelAttribute 注解获取请求参数

还有一种 @RequestBody 的使用方式，本文则主要介绍这种传参的使用姿势和相关注意事项
//-------------------------------（以下原文）
I. 使用姿势

服务接口
借助Spring框架，使用@RequestBody并没有什么难度，很简单的就可以写一个使用case出来，如下
@Slf4j
@RestController
public class ReqBodyController {
@Data
@NoArgsConstructor
@AllArgsConstructor
public static class Req {
private String key;
private Integer size;
}

@RequestMapping(value = “/body”, method = {RequestMethod.POST, RequestMethod.GET, RequestMethod.OPTIONS})
public BaseRsp body(@RequestBody Req req) {
log.info(“req: {}”, req);
return new BaseRsp<>(req);
}
}
复制代码看上面的实现，和我们通常的写法并无差别，无非是将以前的 @RequsetParam 注解换成 @RequsetBody 注解，而且这个注解内部只有一个filed，比RequsetParam还少
@Target({ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface RequestBody {
// 默认参数必须存在，否则会抛一个异常
boolean required() default true;
}
复制代码看到上面的实现，估计也可以猜出，这个注解对于后端而言，写没啥问题，关键是如何用（具体来讲是如何给前端用）
接口调用
上面写完了，接下来的重点就是如何使用了，在使用之前，有必要了解下 RequestBody 这个注解出现的原有以及应用场景（换句话说它和RequestParam有什么区别，为什么要单独的搞一个这个东西出来）
RequestBody

@requestBody注解常用来处理content-type不是默认的application/x-www-form-urlcoded编码的内容，比如说：application/json或者是application/xml等。一般情况下来说常用其来处理application/json类型。

a. content-type定义
在进入下一步之前，有必要说一下Content-Type这个http请求头的作用了，下面一段来自其他博文，原文链接见最后

MediaType，即是Internet Media Type，互联网媒体类型；也叫做MIME类型，在Http协议消息头中，使用Content-Type来表示具体请求中的媒体类型信息。

常见媒体格式如下:

text/html ： HTML格式
text/plain ：纯文本格式
text/xml ： XML格式
image/gif ：gif图片格式
image/jpeg ：jpg图片格式
image/png：png图片格式

以application开头的媒体格式类型：

application/xhtml+xml ：XHTML格式
application/xml ： XML数据格式
application/atom+xml ：Atom XML聚合格式
application/json ： JSON数据格式
application/pdf ：pdf格式
application/msword ： Word文档格式
application/octet-stream ：二进制流数据（如常见的文件下载）
application/x-www-form-urlencoded ：中默认的encType，form表单数据被编码为key/value格式发送到服务器（表单默认的提交数据的格式）

b. content-type 实例说明
上面算是基本定义和取值，下面结合实例对典型的几种方式进行说明

application/x-www-form-urlencoded：数据被编码为名称/值对。这是标准的编码格式。
multipart/form-data：数据被编码为一条消息，页上的每个控件对应消息中的一个部分。
text/plain：数据以纯文本形式(text/json/xml/html)进行编码，其中不含任何控件或格式字符

对于前端使用而言，form表单的enctype属性为编码方式，常用有两种：application/x-www-form-urlencoded和multipart/form-data，默认为application/x-www-form-urlencoded。
Get请求
发起Get请求时，浏览器用application/x-www-form-urlencoded方式，将表单数据转换成一个字符串(key1=value1&key2=value2…)拼接到url上，这就是我们常见的url带请求参数的情况
Post表单
发起post请求时，如果没有传文件，浏览器也是将form表单的数据封装成k=v的结果丢到http body中，拿开源中国的博客提交的表单为例，一个典型的post表单，上传的数据拼装在form data中，为kv结构

如果有传文件的场景，Content-Type类型会升级为multipart/form-data，这一块不详细展开，后面有机会再说
Post json串
post表单除了前面一种方式之外，还有一种也是我们常见的，就是讲所有的表单数据放在一个大的json串中，然后丢给后端，这里也有一个在线的实例，某电商平台的商品发表，截图如下

注意看上面的Request Payload，是一个大的json串，和前面差别明显
c. RequestBody请求
根据RequestBody的定义，要想访问前面定义的那个接口，使用传统的表单传递方式是不行的，curl命令测试如下
curl -X POST -d ‘key=haha&size=123’ http://127.0.0.1:19533/body
复制代码后端对应的输出如下（抛了一个异常，表示@RequestBody注解修饰rest接口，不支持 Content type ‘application/x-www-form-urlencoded;charset=UTF-8’

因此使用姿势需要显示添加请求头，传参也改变一下
curl -l -H “Content-type: application/json” -X GET -d ‘{“key”: “!23”, “size”: 10}’ http://127.0.0.1:19533/body
复制代码返回结果如下

注意事项
a. content-type显示指定
根据前面的说明，可以知道 @RequestBody 这个注解的使用，使得REST接口接收的不再content-type为application/x-www-form-urlencoded的请求, 反而需要显示指定为application/json
b. 请求方法
RequestBody支持GET方法么？前面都是采用post提交参数，如果改成GET会怎样？
curl测试方式
curl -l -H “Content-type: application/json” -X GET -d ‘{“key”: “!23”, “size”: 10}’ http://127.0.0.1:19533/body?key=app
复制代码对应的后端debug截图如下，发现使用GET方式，并没有问题，依然可以获取到参数

换成大名鼎鼎的POSTMAN来测试
使用post方法请求时，截图如下，主要就是修改header的content-type，然后在body中添加json串格式的请求

然而改成get之后，body都直接灰掉了，也就是它不支持在get请求时，提交Body数据

url请求方式
接下来直接换成url的请求方式，看是否直接支持get请求
http://127.0.0.1:19533/body?{“key”: “!23”, “size”: 10}
复制代码浏览器中输入时，服务器400, 换成curl方式请求，抛的是缺少RequestBody的异常，也就是说，将json串拼接到url中貌似不行（也有可能是我的使用姿势不对。。。）
小结

到这里小结一下，使用RequestBody获取参数时，还是老老实实的选择POST方法比较合适，至于原因，跟大众，随主流，跟着大家的习惯走比较好

c. 参数获取
这个主要就是后端编写接口时，获取RequestBody参数的问题了，通过测试，发现在HttpServletRequest参数中，居然拿不到提交的RequestBody参数，演示如下
请求url为
curl -l -H “Content-type: application/json” -X POST -d ‘{“key”: “!23”, “size”: 10}’ http://127.0.0.1:19533/body?url=ddd
复制代码对应的debug截图如下，url参数可以拿到，RequestBody参数没有

首先声明，下面的这段分析，没有看源码，纯属于个人推断，如有问题，对被误导的朋友表示歉意，也希望对此有了解的朋友，多多批评指正
从传文件的思路出发，前端传文件给后端时，后端是基于流的方式，将上传的二进制流，写入到MultipartFile；而二进制流读完之后，没法再重复的读
RequestBody可能也是这么个逻辑，首先是从HttpServletRequest的Reader流中读取body参数并封装到上面的req对象，而不会像url参数一样，写回到javax.servlet.ServletRequest#getParameterMap
复制代码
对上面的猜测做一个小小的验证，改成直接从HttpServletRequest的Reader流中获取请求body参数
@RequestMapping(value = “/body”, method = {RequestMethod.POST, RequestMethod.GET, RequestMethod.OPTIONS})
public BaseRsp body(HttpServletRequest request) throws IOException {
BufferedReader reader = request.getReader();
StringBuilder builder = new StringBuilder();
String line = reader.readLine();
while (line != null) {
builder.append(line);
line = reader.readLine();
}
reader.close();

String reqBody = builder.toString();
Req req = JSON.parseObject(reqBody, Req.class);
log.info("req: {}, request: {}", req, request.getParameterMap());
return new BaseRsp<>(req);

}
复制代码验证如下

其实到这里，有个有意思的地方已经引起了我的好奇，那就是在Spring容器中HttpServletRequest这个东西，是怎么运转的，后面有机会再聊，此处不展开…
4. 小结

ReuqestBody 主要是处理json串格式的请求参数，要求使用方指定header content-type:application/json
RequestBody 通常要求调用方使用post请求
RequsetBody参数，不会放在HttpServletRequest的Map中，因此没法通过javax.servlet.ServletRequest#getParameter获取

作者：一灰灰
链接：https://juejin.im/post/5b5efff0e51d45198469acea
来源：掘金
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

SpringMVC之请求参数的获取方式
https://blog.hhui.top/hexblog/2018/01/04/SpringMVC之请求参数的获取方式/
Http中Content-Type的详解
https://blog.csdn.net/danielzhou888/article/details/72861097

HTTP中支持的Content-Type:
http://tool.oschina.net/commons

以上还看不懂？这样理解
@ResponseBody用法（响应之后）
作用:

该注解用于将Controller的方法返回的对象，根据HTTP Request Header的Accept的内容,通过适当的HttpMessageConverter转换为指定格式后，写入到Response对象的body数据区。
使用时机：

返回的数据不是html标签的页面，而是其他某种格式的数据时（如json、xml等）使用.

@RequestBody使用
作用:

注解用于将Controller的方法参数，根据HTTP Request Header的content-Type的内容,通过适当的HttpMessageConverter转换为JAVA类

使用时机：

POST或者PUT的数据是JSON格式或者XML格式,而不是普通的键值对形式.

SpringMVC @ResponseBody和@RequestBody使用
https://www.jianshu.com/p/7097fea8ce3f

Spring之RequestBody的使用

猜你喜欢