SpringBoot传递单一参数时@RequestParam和@RequestBody的区别小结

用SpringBoot框架做项目时，经常需要前端给后端传递参数，如果需要多条参数，通常的做法是把这些参数封装为一个对象来传递，前端用POST方式调用。但有时会遇到后端只需要一条参数（比如一个String）的情况，此时如果还封装为一个对象，有些多余；最好的办法是用GET方式调用，直接把参数拼接在url后面。但，一般项目都有统一的接口规范，要求接口都要用POST方式，此时就遇到一个问题：controller方法上到底是用@RequestParam注解还是用@RequestBody注解？

之前对这两个注解的区别，只有一个粗枝大叶的理解——@RequestParam针对单一的参数，而@RequestBody针对多个参数封装为一个对象，问了身边几个同事，大概也都是这种理解。但是，实际测试中（使用Postman），当我用@RequestParam接受String的单一参数时，前端给我传递的参数却接收不到。于是决定通过实验，彻底搞明白二者的区别（针对单一参数、POST方法的场景）。实验的过程是分别用@RequestParam和@RequestBody两个注解去接受前端传递的一个名为content的String。

实验一：使用@RequestParam注解

Controller方法代码：（省略其他部分以及返回值Result代码）

@RequestMapping(value="/requestParam", method= RequestMethod.POST, produces = "application/json;charset=UTF-8")
public Result<String> requestParam(@RequestParam("content") String content) {
	System.out.println("content:"+content);
	return success(new Result<String>(), content);

现在我用postman来测试几种可能的参数传递方式：

1. 在Body的raw里面传递，也是最通常的传参方式：

结果是接收不到（不管是用text还是json等各种文本形式）！

 { "timestamp": 1544798083474,
    "status": 400,
    "error": "Bad Request",
    "exception": "org.springframework.web.bind.MissingServletRequestParameterException",
    "message": "Required String parameter 'content' is not present",
    "path": "/testParam/requestParam"
  }

2. 在Headers里通过key-value的形式传递。这是网上一些帖子里说的方式。

但结果还是接收不到！和上面一样报错400。

关于这一点，网上有些帖子里说@RequestParam的参数会写到Headers里，可见是错误的，并非在Headers里，还是在Body里。

3. 在Body的form-data里通过key-value的形式传递，可以接收！

但是，前端调后端接口传参时，是无法向这个form-data里传递参数的，所以这种方法只能被排除。

4. 在url后问号拼接参数。和很多人一样，之前一直根深蒂固地认为只有GET方式才能用url问号传参，POST方式不行，但事实证明在这里问号传参POST方式同样能接收到。如图：

虽然能接受到参数，但前端也有统一的规范，一般不使用问号传参的方式，所以这种方法也被排除。

实验二：使用@RequestBody注解

@RequestMapping(value="/requestBody", method= RequestMethod.POST, produces = "application/json;charset=UTF-8")
public Result<String> requestBody(@RequestBody String content) {
	System.out.println("content:"+content);
	return success(new Result<String>(), content);
}

既然是Body，自然不能在header里传参，也不能在url里问号传参。至于Body的form-data，经测试也无效。所以，这里只有唯一一种方式，就是将参数直接写在Body的raw模式下，实验结果：可以接收到，如图：

注意：这里body体里面传什么内容，后台就会原样接收，所以不要写成content: XXX这种键值对形式，而应直接把String的内容写在body体里。

总结：

对于传递单一参数（最典型的是String）的场合，理论上最简便的方法是用GET请求。但鉴于很多项目接口统一要求使用POST方式，此时不能使用@RequestParam方式，因为此方式前端传递的参数后端无法接收；而只能用@RequestBody，直接将需要的参数内容写入Body体，后端即可正常获取！

到此这篇关于SpringBoot传递单一参数时@RequestParam和@RequestBody的区别小结的文章就介绍到这了,更多相关SpringBoot @RequestParam @RequestBody内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！