Spring MVC客户端参数接收功能讲解

在MVC结构中,控制器组件主要的功能就是接收请求、处理请求、生成响应,接收客户端传来的请求参数的往往是控制器要做的第一件事。

Book实体类Book.java

public class Book {
private Integer bookId;
private String author;
//生成Get、Set方法,此处省略
}

一、直接用参数名匹配请求参数

客户端界面(表单):

controller层:
@Controller
public class ParamPassDemo {
@RequestMapping(value="/queryString")
public String test1(Integer bookId, String author) {
System.out.println("bookId="+bookId+", author="+author);
//此处返回的地址为(/WEB-INF/jsp/index.jsp)
return "index";
}
}

注意:这里@RequestMapping中只有value属性,value可以省略不写。

客户端输入:123,Rose

控制台输出:bookId=123, author=Rose

二、通过@RequestParam注解来指定请求参数的name

客户端界面(表单):

如果表单中的字段与方法中的参数名一致,可以不需要@RequestParam,Spring会自动处理。

controller层:

@Controller
public class ParamPassDemo {
@RequestMapping("/queryStringWithSpecName")
public String test2((value="bookId",required=false) Integer id, @RequestParam("author") String name) {
System.out.println("bookId="+id+", author="+name);
return "index";
}
}

注意:这里@RequestMapping中有两个属性,value不能省略。

@RequestParam将请求地址中的参数传递给目标方法,在处理方法入参处使用可以把请求参数传递给请求方法。

当使用@RequestParam注解时,设置客户端传递的请求参数name="bookId"和@RequestParam的value值value="bookId"相匹配后,参数名int id可以和请求参数不匹配。

客户端输入:321, Jack

控制台输出:bookId=321, author=Jack

客户端界面(ajax):

点我

function clickMe() {
$.ajax({
type : 'POST',
url : "/queryStringWithSpecName",
data : {
"bookId" : 1,
"author" : "Jack"
},
});
}

controller层:(不变)

客户端: data:{"author" : "Jack"}

控制台输出: bookId=null, author=Jack(如果bookId为int类型,控制台会抛出异常)

客户端: data:{"bookId" : 1}

控制台输出: org.springframework.web.bind.MissingServletRequestParameterException: Required String parameter 'author' is not present

通过required设置可选参数,required为false时表示可以不带参数,为true时表示必须带参数(默认值为true)。

当可选参数不存在时,Spring默认将其赋值为空(null),但由于bookId已定义为基本类型int,所以赋值会失败。解决方法:采用int包装类Integer。

三、使用领域对象来接收参数

客户端界面(表单):

controller层:
@Controller
public class ParamPassDemo {
@RequestMapping("/queryStringWithDomainObj")
public String test3(Book book) {
System.out.println("bookId="+book.getBookId()+", author="+book.getAuthor());
return "index";
}
}

客户端输入:111, Bob

控制台输出:bookId=111, author=Bob

四、URL动态参数传递(路径参数)

客户端界面(超链接):

testPathVariable
controller层:
@Controller
public class ParamPassDemo {
//@PathVariable可以用来映射URL中的占位符到目标方法的参数中
@RequestMapping("/book/{bookId}")
public String test4(@PathVariable("bookId") Integer bookId) {
System.out.println("bookId:" + bookId);
return "index";
}
}

控制台输出:bookId:1

@PathVariable 映射 URL 绑定的占位符

通过 @PathVariable 可以将 URL 中占位符参数绑定到控制器处理方法的入参中:URL 中的 {xxx} 占位符可以通过@PathVariable(“xxx“) 绑定到操作方法的入参中。

五、使用HttpServletRequest获取请求参数

客户端界面(表单):

controller层:
@Controller
public class ParamPassDemo {
@RequestMapping("/queryBook")
public String test5(HttpServletRequest request) {
System.out.println("bookId:" + request.getParameter("bookId"));
//此处index.jsp界面在WEB-INF下
return "redirect:/index.jsp";
}
}

客户端输入:123

控制台输出:用户id:123

六、跳转到另一个controller方法

客户端界面(url地址栏):http://localhost:8080/test6?bookId=321

controller层:
@Controller
public class ParamPassDemo {
@RequestMapping("/test6")
public String test6(String bookId){
System.out.println("bookId="+bookId);
//使用服务端跳转的方式转向到另一个controller
//return "forward:queryBook?bookId="+bookId;
return "redirect:queryUser?bookId="+bookId;
}
}

控制台输出:bookId=321 bookId:321

解决SpringMVC接收不到ajaxPOST参数的问题

问题

今天遇到一个问题,代码如下

java:

@PostMapping(value = "/method")
@ResponseBody
public Object method(Integer id,String audit_content) {
return null;
}
js:
var data = {id:7,audit_content:"11111111111111111111a1"};
$.ajax({
type: "POST",
url: "/method",
data:data,
contentType: "application/json;charset=utf-8",
success: function (result) {
$("#my_result").html(JSON.stringify(result));
},
error: function () {
console.log("shibai")
}
});

这样的话,java后台的id和audit_content永远都是null;就算用HttpServletRequest的getParameter("id")也一样没用。

解决

原因是js代码里的contentType: "application/json;charset=utf-8",删掉或者改成默认的"contentType: application/x-www-form-urlencoded"就行了。

拓展

那么什么时候用contentType: "application/json;charset=utf-8"呢,后台不是接收单个字符串,而是一个实体类时就用它了。

java代码:

@PostMapping("/method2")
@ResponseBody
@Transactional
public Object method2(@RequestBody Body body) {
return null;
}

js代码:

var data = {"id": i, "show_status":0};
$.ajax({
type: "POST",
url: "/method2",
data: JSON.stringify(data),
contentType: "application/json;charset=utf-8",
success: function (result) {
$("#my_result").html(JSON.stringify(result));
},
error: function () {
console.log("shibai")
}
});

这样java后台会得到一个有id和show_status属性的Body类,注意一定要JSON.stringify(data),不能直接传data。