Spring 注解之@RequestParam和@GetMapping
@RequestParam用来处理Content-Type 为 application/x-www-form-urlencoded编码的内容,将请求参数名映射到方法参数名。在Http协议中,如果不指定Content-Type,则默认传递的参数就是application/x-www-form-urlencoded类型。接下来我们结合测试用例看一下@RequestParam注解的三个主要参数。
@RestController
@RequestMapping("/user")
public class UserController {
private static Logger logger = LoggerFactory.getLogger(UserController.class);
@GetMapping("/viewUserByBean")
public User viewUserByBean(User user) {
logger.info("@GetMapping中请求参数 ownerId = " + user.getId());
user.setName(user.getName() + " --> lucy");
return user;
}
@RequestMapping(value ="/viewUserByEachEle",method = RequestMethod.GET)
public User viewUserByEachEle(@RequestParam(value = "id", required = false, defaultValue = "1") Long ownerId,
@RequestParam("userName") String name) {
logger.info("请求参数 ownerId = " + ownerId);
User user = new User();
user.setId(ownerId);
user.setName(name + " --> lucy");
return user;
}
@GetMapping("/testRequestParam")
public String testRequestParam(@RequestParam(value = "id", required = false, defaultValue = "1") Long ownerId,
@RequestParam("userName") String name) {
logger.info("testRequestParam, userName: " + name + ", id: "
+ ownerId);
return "SUCCESS";
}
}
// 定义User Bean
public class User implements Serializable {
private static final long serialVersionUID = 7797704227043955944L;
private Long id;
private String name;
// omit getter、setter and toString
}
使用postman模拟ajax请求,URL为http://localhost:8080/user/viewUserByEachEle?userName=licy&id=1002:
@RequestParam
接收get请求参数时,可以通过@RequestParam接收简单类型的属性,如果请求参数特别多,则代码位可读性很差,故推荐通过实体类(如viewUserByBean方法)接收。创建一个实体类对象作为参数承载体,Spring MVC会根据参数名称自动将参数绑定到实体类对象的属性上,viewUserByBean就是这么处理的。下面介绍@RequestParam注解的三个属性:
value:String 类型,请求参数名,如viewUserByEachEle 方法中的userName表示请求参数名,它的值将被绑定到方法参数name。
required:是否必须,默认值为true,表示请求参数中必须包含对应的参数,否则,将抛出400错误码;异常信息是org.springframework.web.bind.MissingServletRequestParameterException,提示“Required String parameter 'userName' is not present”。
defaultValue:String 类型,表示如果请求中没有同名参数时的默认值,默认值可以是SpEL表达式,如“#{systemProperties['java.vm.version']}”。
其实如果不使用@RequestParam,Spring MVC也会将request的parameter自动绑定到method的parameter中,使用@RequestParam只不过是对parameter进行配置和对URL更精确化的配置。例如,在请求参数名和方法参数名相同时,则可以省略@RequestParam注解。
@GetMapping
@GetMapping是一个组合注解,等价于@RequestMapping(method = RequestMethod.GET),它将HTTP Get请求映射到特定的处理方法上。例如,在测试用例中,使用@GetMapping("/testRequestParam")代替了@RequestMapping(value ="/viewUserByEachEle",method = RequestMethod.GET),显然,这可以精简我们的代码。