@RequestBody 接收数组、List 参数、@Deprecated 标记废弃方法

Java SpringBoot

@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<Map<String,Object> 参数

完全与数组同理，后台 MVC 代码：

/**
 * @param ids ：接收页面单个：字符串 List。必须加 @RequestBody 注解
 * @return
 */
@PostMapping("save2")
public String save2(@RequestBody List<String> 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<Map>
 *
 * @param mapList
 * @return
 * @throws JsonProcessingException
 */
@PostMapping("backupSalary")
public String backupSalary(@RequestBody List<Map<String,Object>> mapList) throws JsonProcessingException {
    System.out.println(mapList);
    ObjectMapper objectMapper = new ObjectMapper();
    String result = objectMapper.writeValueAsString(mapList);
    return result;
}

接收整形数组

整型 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<User> userList) {
    for (User user : userList) {
        logger.info("save3--->" + user);
    }
    return new Date() + "传输完毕：" + userList;
}

前端 ajax 代码：

//后台是 List<User>，则前台使用数组([])表示 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;
    }   
}