方法参数属性params,@PathVariable和@RequestParam用法及区别

2022-11-13 18:11:24 属性 区别 用法

【1】params

您可以根据请求参数条件缩小请求映射范围。

您可以测试是否存在请求参数(myParam),是否缺少一个(!myParam),或针对特定值(myParam=myValue)。

以下示例显示了如何测试特定值:

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

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

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

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

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

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

【2】@PathVariable绑定URL中变量

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

① 前台实例

  • GET实例
Request URL:Http://localhost:8080/springMVC-1/springmvc/testPathVariable/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>

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

② 后台代码

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

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

③ 注解源码

@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;

【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;
}

② 前台请求实例

  • GET
<a href="springmvc/testRequestParam?userName=tom&age=11&sex=boy" rel="external nofollow" >
  • 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>

注意 :

  • 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";
}

以上为个人经验,希望能给大家一个参考,也希望大家多多支持。

相关文章