SpringMVC前后端参数传递方式汇总
1. 方案
（1）POST表单提交
前端代码：
var param = {
"username": "admin",
"password": "admin"
}
$.ajax({
url: "/sys/login",
data: param,
contentType: "application/x-www-form-urlencoded; charset=UTF-8", // 不配置也行，默认的就是这个
type: "post",
dataType: "json",
success: function(data) {
}
});后端代码：
@RestController
@RequestMapping("/sys")
public class LoginController {
private static final Logger logger = LoggerFactory.getLogger(LoginController.class);
@PostMapping("/login")
public Result login(String username, String password){
logger.info("用户登录"+username);
// 业务逻辑
return Result.ok("登录成功");
}
// 这样直接用实体类接收也是可以接收到的
@PostMapping("/login2")
public Result login2(SysUser user){
logger.info("{}，用户注册",user.getUsername());
//业务逻辑
return Result.ok("注册成功");
}
}当然，你也可以这么实现，@RequestParam(value="username", required=true) ，required 默认为 true，如果前台不传递此参数，后台会报错。如果设置为 false，如果不传，默认为 null。
@PostMapping("/login")
public Result login(@RequestParam(value="username", required=true) String username,
@RequestParam(value="password", required=true) String password){
logger.info("用户登录"+username);
// 业务逻辑
return Result.ok("登录成功");
}（2）POST传递body
前端代码，提交方式与登录基本保持一致。
var param = {
"username": "admin",
"password": "admin"
}
var paramStr = JSON.stringify(param);
$.ajax({
url: "/sys/login",
data: paramStr,
type: "post",
contentType: "application/json",
dataType: "json",
success: function(data) {
}
});后端代码：
用一个对象来接收前台参数，一般后端有对应的实体类。
/**
* 注册
*/
@PostMapping("/register")
public Result register(@RequestBody SysUser user){
logger.info("{}，用户注册",user.getUsername());
//业务逻辑
return Result.ok("注册成功");
}（3）多参数无实体一
前端代码：
var param = {
"title": "爪哇笔记",
"content": "一个有趣的公众号",
"author": "小柒2012"
}
param = JSON.stringify(param);
$.ajax({
url: "/sys/multiParameter",
data: param,
type: "post",
contentType: "application/json",
dataType: "json",
success: function(data) {
}
});后端实现：
/**
* 多参数
*/
@PostMapping("/multiParameter")
public Result register(@RequestBody Map<String,Object> map){
logger.info("多参数传递:{},{}",map.get("title"),map.get("content"));
//业务逻辑
return Result.ok("接收多参数成功");
}（4）多参数无实体二
前端代码：
var param = {
"title": "爪哇笔记",
"content": "一个有趣的公众号",
"author": "小柒2012"
}
$.ajax({
url: "/sys/multiParameter",
data: param,
type: "post",
dataType: "json",
success: function(data) {
}
});后端实现：
/**
* 多参数
*/
@PostMapping("/multiParameter")
public Result register(@RequestParam Map<String,Object> map){
logger.info("多参数传递:{}, {}", map.get("title"), map.get("content"));
// 业务逻辑
return Result.ok("接收多参数成功");
}（5）传递数组
前端代码：
var param = {
"ids": [1, 2, 3]
}
$.ajax({
url: "/sys/array",
data: param,
type: "post",
dataType: "json",
success: function(data) {
}
});后端实现：
/**
* 数组
*
*/
@PostMapping("array")
public Result array(@RequestParam(value = "ids[]") Integer[] ids) {
logger.info("数据{}", Arrays.asList(ids));
//业务逻辑
return Result.ok();
}（6）传递集合
前端代码与传递数组保持一致。
后端实现
/**
* 集合
*/
@PostMapping("array")
public Result array(@RequestParam(value = "ids[]") List<Integer> ids) {
logger.info("数据{}", ids.toString());
//业务逻辑
return Result.ok();
}（7）传递集合实体对象
比如，后端想接收一个实体对象集合 List
前端代码：
var list = [];
list.push({
"username": "小柒2012",
"mobile": "17762288888"
});
list.push({
"username": "小柒2013",
"mobile": "17762289999"
});
$.ajax({
url: "/sys/listUser",
data: JSON.stringify(list),
type: "post",
contentType: "application/json",
dataType: "json",
success: function(data) {
}
});后端代码：
@PostMapping("listUser")
public Result listUser(@RequestBody List<SysUser> list) {
logger.info("数据{}", list.size());
list.forEach(user->{
//输出实体对象
System.out.println(user.getUsername());
});
//业务逻辑
return Result.ok();
}（8）传递集合实体对象一对多
比如，一个用户有多个角色 List roleList
前端代码：
var roleList = [];
roleList.push({
"roleSign": "admin",
"roleName": "管理员"
});
roleList.push({
"roleSign": "user",
"roleName": "普通用户"
});
var list = [];
var user = {
"username": "小柒2012",
"mobile": "17762288888"
};
user.roleList = roleList;
list.push(user);
$.ajax({
url: "/sys/listUserRole",
data: JSON.stringify(list),
type: "post",
contentType: "application/json",
dataType: "json",
success: function(data) {
}
});后端实现：
@PostMapping("listUserRole")
public Result listUserRole(@RequestBody List<SysUser> list) {
logger.info("数据{}", list.size());
list.forEach(user->{
List<SysRole> roleList = user.getRoleList();
roleList.forEach(role->{
System.out.println(role.getRoleName());
});
});
return Result.ok();
}（9）复杂情况
传输对象有实体，有集合，有各种类型的数据，这时候最简单的方式就是传递 Key-Value 结构的 JSON 字符串，后台 Map 类型接收，然后通过FastJson的 JSON.parseObject() 和 JSON.parseArray() 方法转化为对应的实体或者集合。
String user = parseMap.get("user").toString();
SysUser sysUser = JSON.parseObject(user,SysUser.class);
String contractClause = parseMap.get("rules").toString();
List<Rule> ruleList = JSON.parseArray(contractClause,Rule.class);（10）RESTful 风格
比如，访问某篇文章：
@GetMapping("article/{id}")
public void article(@PathVariable("id") String id) {
logger.info("文章{}",id);
//业务逻辑
}2. 原则
记住以下几点：
●@RequestBody注解，必须与 contentType 类型application/json配合使用。
●@RequestParam注解，必须与 contentType 类型application/x-www-form-urlencoded配合使用，其为默认类型。
●JSON.stringify() 把对象类型转换为字符串类型，一般配合 @RequestBody注解和contentType 类型application/json使用。
3. 扩展
在以上只涉及了两种 contentType 类型，其实还有两种常见的类型：
multipart/form-data
一般用于表单文件上传，必须让 form 的 enctype 等于这个值。
<form action="/upload" method="post" enctype="multipart/form-data">
<input type="text" name="description" value="爪哇笔记，一个神奇的公众号">
<input type="file" name="myFile">
<button type="submit">Submit</button>
</form>text/xml
做过微信支付的小伙伴一定会知道，微信就喜欢用这种方式，去年还发生过 XXE 漏洞，在解析XML文档时，解析器通过 ENTITY 扩展的功能，读取本地受保护的文件，并且使用扩展功能将受保护的文件发送到远程地址。
