@RequestParam用法及原理，你未必真知道-技术圈

大家好，我是路人，这是 SpringMVC 系列第 23 篇。

前面没有详细介绍 SpringMVC 中各种注解的用法，这里准备一一补上，今天来看@RequestParam 注解的用法。

1、预备知识

接口测试利器 HTTP Client
参数解析器 HandlerMethodArgumentResolver 解密

2、@RequestParam 注解的作用

标注在接口的方法参数上，被标注的参数的值来源于request.getParameter或request.getParameterValues。

推荐阅读：2021 最新版 Java 微服务学习线路图 + 视频

3、@RequestParam 源码

@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface RequestParam {

 /**
  * 对应request中参数名称
  */
 @AliasFor("name")
 String value() default "";

 /**
  * 同value
  */
 @AliasFor("value")
 String name() default "";

 /**
  * 请求中是否必须有这个参数，默认为true
  */
 boolean required() default true;

 /**
  * 默认值
  */
 String defaultValue() default ValueConstants.DEFAULT_NONE;

}

4、案例 1：@RequestParam 指定 name，获取对应参数的值

4.1、案例接口代码

/**
 * {@link RequestParam}中指定name，用来取name的值对应的请求参数中的值
 *
 * @param name：可以不传递name参数，不传递的时候默认值为ready
 * @param age
 * @param pets
 * @return
 */
@RequestMapping("/requestparam/test1")
public Map test1(@RequestParam(value = "name", required = false, defaultValue = "ready") String name, //相当于request.getParameter("name")
                                 @RequestParam("age") int age, //Integer.parseInt(request.getParameter("age"))
                                 @RequestParam("interests") String[] interests, //request.getParameterValues("pets")
                                 @RequestParam("pets") List pets //Arrays.asList(request.getParameterValues("pets"))
) {
    Map result = new LinkedHashMap<>();
    result.put("name", name);
    result.put("age", age);
    result.put("interests", interests);
    result.put("pets", pets);
    return result;
}

4.2、用例 1：所有参数都传值

POST http://localhost:8080/chat18/requestparam/test1
Content-Type: application/x-www-form-urlencoded

name=路人&age=35&interests=篮球&interests=旅游&pets=小狗&pets=小猫

运行上面用例代码输出

{
  "name": "路人",
  "age": 35,
  "interests": [
    "篮球",
    "旅游"
  ],
  "pets": [
    "小狗",
    "小猫"
  ]
}

4.3、用例 2：name 不传递，会取默认值 ready

POST http://localhost:8080/chat18/requestparam/test1
Content-Type: application/x-www-form-urlencoded

age=35&interests=篮球&interests=旅游&pets=小狗&pets=小猫

运行上面用例代码输出

{
  "name": "ready",
  "age": 35,
  "interests": [
    "篮球",
    "旅游"
  ],
  "pets": [
    "小狗",
    "小猫"
  ]
}

4.4、用来 3：required 属性为 true，不传，则报错

POST http://localhost:8080/chat18/requestparam/test1
Content-Type: application/x-www-form-urlencoded

参数都没有传递，而接口要求除 name 之外的，其他几个参数都必须传递，所以这个案例结果会报 400 错，提示 age 参数不存在，这个错误比较常见，大家熟悉下，以后看到了就知道什么问题了。

5、案例 2：@RequestParam 不指定 name，获取所有参数值

当我们想用一个 Map 来接收所有参数的之后，代码如下，@RequestParam 不用指定 name 的值，参数类型为 Map，所有请求参数会以参数名称:值的方式丢在 Map 中。

/**
 * {@link RequestParam}不指定name，用于接收所有参数的值，
 * 参数类型为Map,key为请求中的参数名称，value为值
 *
 * @param paramMap
 * @return
 */
@RequestMapping("/requestparam/test2")
public Map test2(@RequestParam Map paramMap) {
    return paramMap;
}

运行下面的用例调用上面接口

###
POST http://localhost:8080/chat18/requestparam/test2
Content-Type: application/x-www-form-urlencoded

name=路人&age=35&interests=篮球&interests=旅游&pets=小狗&pets=小猫

运行输出

{
  "name": "路人",
  "age": "35",
  "interests": "篮球",
  "pets": "小狗"
}

interests 和 pet 都是有多个值，上面的结果中都只获取了第一个值，如果我们想获取所有的值呢，下面看案例 3。

6、案例 3：@RequestParam 不指定 name，获取所有参数值

/**
 * {@link RequestParam}不指定name，用于接收所有参数的值，
 * 参数类型为MultiValueMap：key为请求中的参数名称，value为值的集合List
 *
 * @param paramMap
 * @return
 */
@RequestMapping(value = "/requestparam/test3", produces = MediaType.APPLICATION_JSON_VALUE)
public MultiValueMap test3(@RequestParam MultiValueMap paramMap) {
    return paramMap;
}

这个接口的参数是MultiValueMap类型，这玩意是干啥的？好像很陌生啊，哈哈

再模式的东西，把其源码放出来，瞬间明了了，如下，可以看出来MultiValueMap相当于Map>

public interface MultiValueMap<K, V> extends Map<K, List<V>> {
}

运行下面的用例调用上面接口，注意下面第 3 行，表示我们期望服务器端返回 json 格式数据

POST http://localhost:8080/chat18/requestparam/test3
Content-Type: application/x-www-form-urlencoded
Accept: application/json

name=路人&age=35&interests=篮球&interests=旅游&pets=小狗&pets=小猫

运行输出，结果的值比较特别，是一个 String 类型的数组，这次获取到所有参数的值了。

{
  "name": [
    "路人"
  ],
  "age": [
    "35"
  ],
  "interests": [
    "篮球",
    "旅游"
  ],
  "pets": [
    "小狗",
    "小猫"
  ]
}

7、@RequestParam 原理

@RequestParam 标注的参数的值是有下面 2 个类处理的，有兴趣了解的建议先看一下上一篇中的：参数解析器 HandlerMethodArgumentResolver 解密，然后再来看下面 2 个类的源码就是小意思了。

org.springframework.web.method.annotation.RequestParamMethodArgumentResolver
org.springframework.web.method.annotation.RequestParamMapMethodArgumentResolver

8、总结

@RequestParam 注解用来标注在控制器方法的参数上，springmvc 从 request 中获取请求的值赋值给方法的参数
@RequestParam 指定 name 时，可以获取 request 中指定参数的值，相当于 request.getParameter(name)或 request.getParameters(name)
@RequestParam 未指定 name，参数类型为：Map时，用来接收 request 中所有参数的值，Map 中 key 为参数名称，value 为参数的值
@RequestParam 未指定 name，参数类型为 MultiValueMap时，用来接收 request 中所有参数的值，key 为请求中的参数名称，value 为值的集合 List
推荐阅读：尚硅谷 Java 学科全套教程（总 207.77GB）

9、代码位置及说明

9.1、git 地址

https://gitee.com/javacode2018/springmvc-series

9.2、本文案例代码结构说明

10、SpringMVC 系列目录

SpringMVC 系列第 1 篇：helloword
SpringMVC 系列第 2 篇：@Controller、@RequestMapping
SpringMVC 系列第 3 篇：异常高效的一款接口测试利器
SpringMVC 系列第 4 篇：controller 常见的接收参数的方式
SpringMVC 系列第 5 篇：@RequestBody 大解密，说点你不知道的
SpringMVC 系列第 6 篇：上传文件的 4 种方式，你都会么？
SpringMVC 系列第 7 篇：SpringMVC 返回视图常见的 5 种方式，你会几种？
SpringMVC 系列第 8 篇：返回 json & 通用返回值设计
SpringMVC 系列第 9 篇：SpringMVC 返回 null 是什么意思？
SpringMVC 系列第 10 篇：异步处理
SpringMVC 系列第 11 篇：集成静态资源
SpringMVC 系列第 12 篇：拦截器
SpringMVC 系列第 13 篇：统一异常处理
SpringMVC 系列第 14 篇：实战篇：通用返回值 & 异常处理设计
SpringMVC 系列第 15 篇：全注解的方式 & 原理解析
SpringMVC 系列第 16 篇：通过源码解析 SpringMVC 处理请求的流程
SpringMVC 系列第 17 篇：源码解析 SpringMVC 容器的启动过程
SpringMVC 系列第 18 篇：强大的 RequestBodyAdvice 解密
SpringMVC 系列第 19 篇：强大的 ResponseBodyAdvice 解密
SpringMVC 系列第 20 篇：RestFull 详解
SpringMVC 系列第 21 篇：接口调用过利器 RestTemplate
SpringMVC 系列第 22 篇：参数解析器 HandlerMethodArgumentResolver 解密

12、最新资料

尚硅谷 Java 学科全套教程（总 207.77GB）
2021 最新版 Java 微服务学习线路图 + 视频
阿里技术大佬整理的《Spring 学习笔记.pdf》
阿里大佬的《MySQL 学习笔记高清.pdf》
2021 版 java 高并发常见面试题汇总.pdf
Idea 快捷键大全.pdf