作者平台：
| CSDN：blog.csdn.net/qq_41153943
| 知乎：www.zhihu.com/people/1024…
| GitHub：github.com/JiangXia-10…
| 微信公众号：1024笔记
本文大约5165字，预计阅读时长13分钟
前言
在springboot中有几种处理url请求参数的注解，它们分别是：
@PathVariable、@RequestHeader、@RequestParam、@MatrixVariable、@RequestBody，今天一起来学习下。
正文
1、@RequestParam
@RequestParam 可以用于将指定的请求参数赋值给方法中的形参。源码如下：
public @interface RequestParam {
@AliasFor("name")
String value() default "";
@AliasFor("value")
String name() default "";
boolean required() default true;
String defaultValue() default ValueConstants.DEFAULT_NONE;
}
复制代码
可以发现它有三个属性：
-
value：请求参数名（必须配置）
-
required：是否必需，默认为 true，即 请求中必须包含该参数，如果没有包含，将会抛出异常（可选配置）
-
defaultValue：默认值，如果设置了该值，required 将自动设为 false，无论你是否配置了required，配置了什么值，都是 false（可选配置）
比如：
@RequestMapping("/testequestparam")
public String testequestParam(@RequestParam("name") String name){
return name+",你好啊！";
}
复制代码
输出结果如下：
因为required参数默认是true，所以是必须的，如果请求地址后面不带参数则会报错：
如果将其值设为false，则请求成功，但是参数值为null：
@RequestMapping("/testequestparam1")
public String testequestParam1(@RequestParam(value="name",required = false) String name){
return name+",你好啊！";
}
复制代码
@RequestParam还可以在参数为空的情况下，为我们设置一个参数的默认值：
@RequestMapping("/testequestparam2")
public String testequestParam2(@RequestParam(defaultValue = "defaultValue") String name){
return name+",你好啊！";
}
复制代码
2、@PathVariable
@PathVariable是spring3.0的一个新功能，用来接收请求路径中占位符的值，源码如下：
public @interface PathVariable {
@AliasFor("name")
String value() default "";
@AliasFor("value")
String name() default "";
boolean required() default true;
}
复制代码
示例：
@GetMapping("/car/{id}/user/{name}/band/{band}")
//http://localhost:8081/share/car/1/user/李四/band/比亚迪/
public String testPathVariable(@PathVariable("id") Integer id,
@PathVariable("name") String name,
@PathVariable("band")String band,
@PathVariable Map<String,String> pv){
return "返回的车是"+name+"的名下id为"+id+"的车,车子的品牌是"+band;
}
复制代码
返回结果如下：
@PathVariable支持返回所有的路径变量：
@GetMapping("/map/car/{id}/user/{name}/band/{band}")
public Map<String,Object> testPathVariableMap(@PathVariable("id") Integer id,
@PathVariable("name") String name,
@PathVariable("band")String band,
@PathVariable Map<String,String> pv){
Map<String,Object> map = new HashMap<>();
map.put("id",id);
map.put("name",name);
map.put("band",band);
map.put("pv",pv);
return map;
}
复制代码
除此之外@PathVariable还有和@RequestParam相同的属性required，用法一样，这里不再说明。
3、@RequestHeader
我们知道一个请求中会包含一些请求头等信息，如下：
@RequestHeader是获取请求头中的数据，通过指定参数 value 的值来获取请求头中指定的参数值。源码如下：
public @interface RequestHeader {
@AliasFor("name")
String value() default "";
@AliasFor("value")
String name() default "";
boolean required() default true;
String defaultValue() default ValueConstants.DEFAULT_NONE;
}
复制代码
通过源码可以发现其他参数用法和 @RequestParam完全一样。示例：
@GetMapping("/map1/car/{id}/user/{name}/band/{band}")
public Map<String,Object> testPathVariableMap1(@PathVariable("id") Integer id,
@PathVariable("name") String name,
@PathVariable("band")String band,
@PathVariable Map<String,String> pv,
@RequestHeader("User-Agent") String useragent,
@RequestHeader Map<String,String> header) {
Map<String, Object> map = new HashMap<>();
map.put("id", id);
map.put("name", name);
map.put("band", band);
map.put("pv", pv);
map.put("useragent",useragent);
map.put("header",header);
return map;
}
复制代码
4、@MatrixVariable
@MatrixVariabl注解拓展了URL请求地址的功能。使用@Matrixvariable注解时多个变量可以使用;(分号)分隔,该注解允许开发者进行多条件组合査询。其源码如下：
public @interface MatrixVariable {
@AliasFor("name")
String value() default "";
@AliasFor("value")
String name() default "";
String pathVar() default ValueConstants.DEFAULT_NONE;
boolean required() default true;
String defaultValue() default ValueConstants.DEFAULT_NONE;
}
复制代码
可以发现其属性和RequestParam基本完全一样，但是多了一个pathVar属性，它表示矩阵变量所在的URI路径变量的名称，如有必要消除歧义（例如，在多个路径段中存在同名的矩阵变量）。示例：
@GetMapping("/phone/{path}")
public Map carsSell(@MatrixVariable("low") Integer low,
@MatrixVariable("band") List<String> brand,
@PathVariable("path") String path){
Map<String,Object> map = new HashMap<>();
map.put("low",low);
map.put("brand",brand);
map.put("path",path);
return map;
复制代码
它和前面的注解直接使用是不行的，需要进行处理，因为SpringBoot默认是禁用了矩阵变量的功能，需要进行处理手动开启，对于路径的处理是通过UrlPathHelper进行解析，removesemicolonconten（移除分号内容）支持矩阵变量：这里写一个配置类：
@Configuration(proxyBeanMethods = false)
public class WebConfig implements WebMvcConfigurer {
@Bean
public HiddenHttpMethodFilter hiddenHttpMethodFilter(){
HiddenHttpMethodFilter hiddenHttpMethodFilter = new HiddenHttpMethodFilter();
hiddenHttpMethodFilter.setMethodParam("_m");
return hiddenHttpMethodFilter;
}
@Override
public void configurePathMatch(PathMatchConfigurer configurer){
UrlPathHelper urlPathHelper = new UrlPathHelper();
//false表示不移除；后面的内容，矩阵变量功能就能生效
urlPathHelper.setRemoveSemicolonContent(false);
configurer.setUrlPathHelper(urlPathHelper);
}
}
复制代码
5、@RequestBody
@RequestBody主要用来接收前端传递给后端的json字符串中的数据的(请求体中的数据的)；而最常用的使用请求体传参的无疑是POST请求了，所以使用@RequestBody接收数据时，一般都用POST方式进行提交。源码如下：
public @interface RequestBody {
boolean required() default true;
}
复制代码
该注解只有一个required属性，默认是true。使用如下：
@PostMapping("/share/save")
public Map postMethod(@RequestBody String content){
Map<String,Object> map = new HashMap<>();
map.put("content",content);
return map;
}
复制代码
总结
以上就是springboot中几个对于请求参数处理的注解，通过这些注解我们能够获取url中的参数然后进行对应的业务开发处理。
如有任何问题或者不对的地方欢迎一起交流讨论学习！
本项目源码在：
欢迎下载、Star！