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

女爷i 2021-12-14 04:45 850阅读 0赞

**目录**

@RequestBody 概述

接收单个 String 参数

接收 字符串数组 参数

接收 List 参数

接收整形数组

接收单个 POJO 对象

接收 POJO List 参数

@Deprecated 标记废弃方法

--------------------

# @RequestBody 概述 #

1、@RequestBody 主要用来接收前端传递给后端的 json 格式的数据的(请求体中的数据的)，有一个属性 required，表示参数是否必须要传，默认为 true.  
  
2、GET 方式无请求体，所以 @RequestBody 接收数据时，前端必须是 POST 方式进行提交，然后给页面的数据默认也是 json  
  
3、同一个方法中，@RequestBody 与 @RequestParam() 可以同时使用，前者最多只能有一个，后者可以有多个，  
  
4、@RequestBody 接收的是请求体里面的数据，@RequestParam 接收的是 key-value 里面的参数。

@RequestParam 请求参数：[https://blog.csdn.net/wangmx1993328/article/details/95040803\#%40RequestParam][https_blog.csdn.net_wangmx1993328_article_details_95040803_40RequestParam]

# 接收单个 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));
        }
    });

![20190709083209150.gif][]

# 接收 字符串数组 参数 #

后台 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 代码：

# 接收 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;
        }

![20191031201208806.gif][]

# 接收整形数组 #

整型 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 代码：

# 接收单个 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 代码：

# 接收 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));
        }
    });

![20190708083845835.gif][]

# @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;
        }   
    }

![20200215102755387.gif][]

[https_blog.csdn.net_wangmx1993328_article_details_95040803_40RequestParam]: https://blog.csdn.net/wangmx1993328/article/details/95040803#%40RequestParam
[20190709083209150.gif]: /images/20211213/00607bf30f4041b9a1f8f82cf004a859.png
[20191031201208806.gif]: /images/20211213/27554ec3c614405e9bfdcc51d47d22f1.png
[20190708083845835.gif]: /images/20211213/a6623e3982bd4e61a4d9c3c06bf29444.png
[20200215102755387.gif]: /images/20211213/872383aca3174d42aa7431055f12f87b.png