@RequestBody 接收数组、List 参数、@Deprecated 标记废弃方法
@RequestBody 概述
1、@RequestBody 主要用来接收前端传递给后端的 json 格式的数据的(请求体中的数据的)，有一个属性 required，表示参数是否必须要传，默认为 true.
2、GET 方式无请求体，所以 @RequestBody 接收数据时，前端必须是 POST 方式进行提交，然后给页面的数据默认也是 json
3、同一个方法中， @RequestBody 与 @RequestParam() 可以同时使用，前者最多只能有一个，后者可以有多个，
4、@RequestBody 接收的是请求体里面的数据， @RequestParam 接收的是 key-value 里面的参数。
接收单个 String 参数
后台代码：
/**
* 单个参数时使用 String 类型传输，比如 int、long、flout 等等，都使用 String
*
* @param uid
* @return
*/
@PostMapping("save4")
public String save4(@RequestBody String uid) {
logger.info("保存单个参数：" + uid);
return "保存完毕：" + uid;
}
前端 ajax 代码：
$.ajax({
//默认传输的内容类型为 key-value 型,后台使用数组、List 接收参数时,
// headers 中必须指定内容类型为 json 类型，否则会报415错误
headers: {
'Content-Type': 'application/json;charset=utf8'
},
type: "post",
url: "http://localhost:8080/user/save4",
//指定 json 类型后，传输的数据理所当然应该是 json 格式。
data: JSON.stringify({"uid": "9527"}),
success: function (data) {
console.log(data);
},
error: function (data) {
console.log("ERROR:" + JSON.stringify(data));
}
});
图片
接收 字符串数组 参数
后台 MVC 代码：
/**
* @param ids ：接收页面单个：参数字符串数组。必须加 org.springframework.web.bind.annotation.RequestBody 注解。
* 如果是整形数组，则换成 Integer[] ids 即可。
* @return
*/
@PostMapping("save1")
public String save1(@RequestBody String[] ids) {
logger.info("save1--->" + Arrays.asList(ids));
return new Date() + "传输完毕：" + Arrays.asList(ids);
}
前端 ajax 代码：
var data = ["18ui", "89uj", "987u", "98uj"];//如果后台接收的是整形数组，则 data 中使用整形即可，如：data = [80, 90, 100, 110,120];
$.ajax({
//默认传输的内容类型为 key-value 型,后台使用数组、List 接收参数时,
// headers 中必须指定内容类型为 json 类型，否则会报415错误
headers: {
'Content-Type': 'application/json'
},
type: "post",
url: "http://localhost:8080/user/save1",
//指定 json 类型后，传输的数据理所当然应该是 json 格式。
data: JSON.stringify(data),
success: function (data) {
console.log(data);
},
error: function (data) {
console.log("ERROR:" + JSON.stringify(data));
}
});
接收 List 参数
完全与数组同理，后台 MVC 代码：
/**
* @param ids ：接收页面单个：字符串 List。必须加 @RequestBody 注解
* @return
*/
@PostMapping("save2")
public String save2(@RequestBody List ids) {
logger.info("save2--->" + ids);
return new Date() + "传输完毕：" + ids;
}
前端 ajax 代码(与数组前端完全一致)：
//因为 ArrayList 底层也是数组，不难明白前端都传数组
var data = [{"name": "华安", "id": 9527, "salary": 8890.98}, {"name": "张三", "id": 9528, "salary": 8790.98}];
$.ajax({
//默认传输的内容类型为 key-value 型,后台使用数组、List 接收参数时,
// headers 中必须指定内容类型为 json 类型，否则会报415错误
headers: {
'Content-Type': 'application/json'
},
type: "post",
url: "http://localhost:8080/user/save2",
//指定 json 类型后，传输的数据理所当然应该是 json 格式。
data: JSON.stringify(data),
success: function (data) {
console.log(data);
},
error: function (data) {
console.log("ERROR:" + JSON.stringify(data));
}
});
/**
* http://localhost:8080/sys/backupSalary
* 页面传入 json 数据：[{"name":"华安","id":9527,"salary":8890.98}]
* 直接转换为 List图片
接收整形数组
整型 List 、Flout等其它类型也是同理，会自动转型。后台代码：
/**
* Long[] ids 参数时，前端也使用整型
*
* @param ids
* @return
*/
@PostMapping("save5")
public String save5(@RequestBody Long[] ids) {
logger.info("save5--->" + Arrays.asList(ids));
return new Date() + "传输完毕：" + Arrays.asList(ids);
}
前端 ajax 代码：
var data = [1, 2, 3, 4, 5, 10, 22];
$.ajax({
//默认传输的内容类型为 key-value 型,后台使用数组、List 接收参数时,
// headers 中必须指定内容类型为 json 类型，否则会报415错误
headers: {
'Content-Type': 'application/json;charset=utf8'
},
type: "post",
url: "http://localhost:8080/user/save5",
//指定 json 类型后，传输的数据理所当然应该是 json 格式。
data: JSON.stringify(data),
success: function (data) {
console.log(data);
},
error: function (data) {
console.log("ERROR:" + JSON.stringify(data));
}
});
接收单个 POJO 对象
后台提供一个 POJO 对象：
class User {
private Integer uId;
private String uName;
public Integer getuId() {
return uId;
}
public void setuId(Integer uId) {
this.uId = uId;
}
public String getuName() {
return uName;
}
public void setuName(String uName) {
this.uName = uName;
}
@Override
public String toString() {
return "User{" +
"uId=" + uId +
", uName='" + uName + '\'' +
'}';
}
}
后台 mvc 代码：
/**
* 保存单个实体
*
* @param user
* @return
*/
@PostMapping("save6")
public String save6(@RequestBody User user) {
logger.info("save6=> " + user.toString());
return "保存完成：" + user;
}
前端 ajax 代码：
var data = {"uId": 1000, "uName": "华安"};
$.ajax({
//默认传输的内容类型为 key-value 型,后台使用数组、List 接收参数时,
// headers 中必须指定内容类型为 json 类型，否则会报415错误
headers: {
'Content-Type': 'application/json;charset=utf8'
},
type: "post",
url: "http://localhost:8080/user/save6",
//指定 json 类型后，传输的数据理所当然应该是 json 格式。
data: JSON.stringify(data),
success: function (data) {
console.log(data);
},
error: function (data) {
console.log("ERROR:" + JSON.stringify(data));
}
});
接收 POJO List 参数
POJO 数组也是同理。后台 MVC 代码：
/**
* @param userList ：接收页面单个：POJO List。必须加 @RequestBody 注解
* @return
*/
@PostMapping("save3")
public String save3(@RequestBody List userList) {
for (User user : userList) {
logger.info("save3--->" + user);
}
return new Date() + "传输完毕：" + userList;
}
前端 ajax 代码：
//后台是 List，则前台使用数组([])表示 List，使用 json 对象表示 User 对象
var data = [];
for (var i = 0; i < 3; i++) {
var user = {};//每一个 json 对象相当于后台的 User 对象，因为都是 key-value 格式。
user.uId = (i + 1);//key 值必须与后台 POJO 属性一致。value 的类型必须与后台数据类型一致。
user.uName = "huaAn_" + (i + 1);
data.push(user);//将 json 对象添加到数组中
}
$.ajax({
//默认传输的内容类型为 key-value 型,后台使用数组、List 接收参数时,
// headers 中必须指定内容类型为 json 类型，否则会报415错误
headers: {
'Content-Type': 'application/json'
},
type: "post",
url: "http://localhost:8080/user/save3",
//指定 json 类型后，传输的数据理所当然应该是 json 格式。
data: JSON.stringify(data),
success: function (data) {
console.log(data);
},
error: function (data) {
console.log("ERROR:" + JSON.stringify(data));
}
});
图片
@Deprecated 标记废弃方法
1、应用中对于外部正在调用或者二方库依赖的接口，不允许修改方法签名，避免对接口调用方产生影响，过时接口可以加上@Deprecated注解，并清晰地说明采用的新接口或新服务是什么。
2、@Deprecated 注解表示 "废弃;不赞成;不推荐使用"，可以标注的位置有：@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})，
3、比如某个类或某方法加上该注解之后，表示此方法或类不再建议使用，调用时编辑器也会自动提示删除线，但并不代表不能用，只是不推荐使用，因为还有更好的方法可以调用。
public class HelloWorld {
//id 不再推荐使用，请使用 uId
@Deprecated
private String id;
private String uId;
//showInfo() 方法不再推荐使用，1.5 版本开始请使用 getInfo
@Deprecated
public void showInfo() {
String info = "天下归心";
System.out.println(info);
}
/**
* @since 1.5
*/
public String getInfo() {
String info = "天下归心";
return info;
}
}
