方法参数相关属性params、@PathVariable和@RequestParam用法与区别_@params

【1】params

您可以根据请求参数条件缩小请求映射范围。您可以测试是否存在请求参数（myParam），是否缺少一个（!myParam），或针对特定值（myParam=myValue）。以下示例显示了如何测试特定值：

@GetMapping(path = "/pets/{petId}", params = "myParam=myValue") 
public void findPet(@PathVariable String petId) {
    // ...
}
1
2
3
4

您还可以将其用于请求头条件，如下例所示：

@GetMapping(path = "/pets", headers = "myHeader=myValue") 
public void findPet(@PathVariable String petId) {
    // ...
}
1
2
3
4

简而言之，params是指定request中必须包含某些参数值时，才让该方法处理。

@RequestMapping(value = "testParamsAndHeaders", params = { "username","age!=10" })
public String testParamsAndHeaders() {
    System.out.println("testParamsAndHeaders");
    return SUCCESS;
}
1
2
3
4
5

params 只是判断url 或者 form data 中的参数是否复合params的定义，并不会直接绑定数据到方法的参数中，起到一个请求过滤作用。

---

【2】@PathVariable绑定URL中变量

绑定路径中的占位符参数到方法参数变量中，只能绑定路径中的占位符参数，且路径中必须有参数。无论是 GET 或者POST 只要 URL中有参数即可！

① 前台实例

GET实例

Request URL:http://localhost:8080/SpringMVC-1/springmvc/testPathVariable/1
1

POST 实例

<form action="springmvc/testPathVariable/1" method="POST">
	<input type="text" name="username" value=""/>
	<input type="text" name="age" value=""/>
	<input type="text" name="sex" value=""/>
	<input type="submit" value="submit"/>
</form>
1
2
3
4
5
6

【注意】如果URL中无参数，将会出错；如果URL有参数，但是没有使用@PathVariabl该注解，那么URL的参数不会默认与方法参数绑定！方法里的参数会默认绑定表单里面对应的参数！

② 后台代码

如果参数名与占位符一致，则可直接使用@PathVariable。如果不一致，则在@PathVariable( )括号内绑定占位符。

@RequestMapping("/testPathVariable/{id}")
public String testPathVariable(@PathVariable("id") Integer id2) {
	System.out.println("testPathVariable: " + id2);
	return SUCCESS;
}
1
2
3
4
5

③ 注解源码

@PathVariable 注解指示方法参数应绑定到URI模板变量。支持@RequestMapping注解的处理程序方法。如果方法参数类型为java.util.Map Map<String,String>,该方法参数将会被所有路径变量name-value填充。

@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface PathVariable {
	@AliasFor("name")
	String value() default "";

	 //路径变量绑定的名称
	@AliasFor("value")
	String name() default "";
	
	 //路径变量是否必须。默认为true，当路径变量不存在时抛出异常。
	 //如果当路径变量不存在时，你倾向赋予null或者Java 8的Optional，请设置为false，
	 //例如，在一个@ModelAttribute注解的方法处理不同的请求时。
	boolean required() default true;

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

---

【3】@RequestParam

@RequestParam注解指示方法参数应绑定web请求参数。Spring MVC和Spring WebFlux中的注解处理程序方法支持如下：

在SpringMVC中，“request parameters”映射查询参数、表单数据和multipart requests中的参数。这是因为ServletAPI将查询参数和表单数据组合到一个a single map called "parameters"，其中包括请求body的自动解析。

在Spring WebFlux中，“request parameters”只映射到查询参数。要在三部分起作用(query parameters, form data,and parts in multipart requests)，可以使用数据绑定到用@ModelAttribute注解的命令对象。

如果方法参数类型为Map，并且指定了请求参数名称，则假设有适当的转换器可用，则请求参数值将转换为Map。

如果方法参数为java.util.Map Map<String,String>或org.springframework.util.MultiValueMap MultiValueMap<String,String>,如果未指定参数名，则方法参数Map会被所有的请求参数名-值填充。

① 注解源码

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

	@AliasFor("name")
	String value() default "";

	//请求参数要绑定的名称
	@AliasFor("value")
	String name() default "";
/
	 //请求参数是否必须，默认为true。如果参数不存在，则抛出异常。
	 //你可以选择设置为false或者给予默认值。
	boolean required() default true;

	 //当请求参数不存在或为空时，使用默认值。提供一个默认值将会隐形设置required属性为false。
	String defaultValue() default ValueConstants.DEFAULT_NONE;

}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

---

② 前台请求实例

GET

<a href="springmvc/testRequestParam?userName=tom&age=11&sex=boy">
1

POST

<form action="springmvc/testRequestParam" method="POST">
	<input type="text" name="userName" value=""/>
	<input type="text" name="age" value=""/>
	<input type="text" name="sex" value=""/>
	<input type="submit" value="submit"/>
</form>
1
2
3
4
5
6

注意 ：

• GET中的参数形式为：username=tom&age=11&sex=boy

• POST中的参数形式为：以键值对形式保存在form data
  

---

③ 后台代码

@RequestMapping(value="/regist",produces="application/json;charset=utf-8")
@ResponseBody
public String regist(SysUser sysUser , @RequestParam(required=true,name="sex") String sex){
	String userName = sysUser.getUserName();
	String age = sysUser.getAge();
	//...
	return "regist success";
}
1
2
3
4
5
6
7
8