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

IDEA插件实现Spring Boot接口自动同步YApi:原理、配置与避坑指南 在前后端分离架构中,API接口文档是团队协作的核心契约。其核心原理在于通过解析代码抽象语法树(AST)提取接口元数据,并转换为目标平台的文档模型。这项技术的核心价值在于将文档维护从手动、滞后的人工流程,转变为自动化、实时同步的工程实践,从而显著提升开发效率并保障契约一致性。其典型应用场景是使用Spring Boot等框架的中大型Java团队,需要将IDE中编写的接口代码与YApi等接口管理平台进行同步。本文以EasyApi插件为例,深入解析了如何通过IDEA插件实现Spring Boot接口到YApi的自动 阅读详情

点击上方“芋道源码”,选择“设为星标”

管她前浪,还是后浪?

能浪的浪,才是好浪!

每天 10:33 更新文章,每天掉亿点点头发...

源码精品专栏

 

来源:wangmaoxiong.blog.youkuaiyun.com/

article/details/95042420/

e61e71f7d227bd301a4327a1ad96ad98.png


@RequestBody 概述

1、@RequestBody 主要用来接收前端传递给后端的 json 格式的数据的(请求体中的数据的),有一个属性 required,表示参数是否必须要传,默认为 true.

2、GET 方式无请求体,所以 @RequestBody 接收数据时,前端必须是 POST 方式进行提交,然后给页面的数据默认也是 json

3、同一个方法中, @RequestBody 与 @RequestParam() 可以同时使用,前者最多只能有一个,后者可以有多个,

4、@RequestBody 接收的是请求体里面的数据, @RequestParam 接收的是 key-value 里面的参数。

基于 Spring Boot + MyBatis Plus + Vue & Element 实现的后台管理系统 + 用户小程序,支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能。

项目地址:https://github.com/YunaiV/ruoyi-vue-pro

接收单个 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));
    }
});
33d7e9964b868a05587fce453312726c.gif

基于微服务的思想,构建在 B2C 电商场景下的项目实战。核心技术栈,是 Spring Boot + Dubbo 。未来,会重构成 Spring Cloud Alibaba 。

项目地址:https://github.com/YunaiV/onemall

接收 字符串数组 参数

后台 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;
    }
4d80f75dc510f19cbb20e71d8124e66b.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 代码:

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));
    }
});
753f452e0a1fd7f99cfab06b4651a63e.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;
    }   
}
6fd7e680f66a24d3daaaea24dbce981d.gif

欢迎加入我的知识星球,一起探讨架构,交流源码。加入方式,长按下方二维码噢:

e276825072fb652e7c7c89e2bd63ac1e.png

已在知识星球更新源码解析如下:

5af09f748b0ee919072c5ee61cf1a567.png

97f3f770ba234b416856f463b46d457b.png

59b817899d37236781986063e7849e64.png

e57c6c907163d01091d8a5f110609d37.png

最近更新《芋道 SpringBoot 2.X 入门》系列,已经 101 余篇,覆盖了 MyBatis、Redis、MongoDB、ES、分库分表、读写分离、SpringMVC、Webflux、权限、WebSocket、Dubbo、RabbitMQ、RocketMQ、Kafka、性能测试等等内容。

提供近 3W 行代码的 SpringBoot 示例,以及超 4W 行代码的电商微服务项目。

获取方式:点“在看”,关注公众号并回复 666 领取,更多内容陆续奉上。

文章有帮助的话,在看,转发吧。
谢谢支持哟 (*^__^*)
Trae Solo模式:本地化AI文档生成系统原理与实践 API文档自动化生成是现代软件工程中提升协作效率与交付质量的关键环节。其核心原理在于从代码、注释、数据库Schema及Git历史等多源异构数据中构建可推理的知识图谱,并基于语义理解而非模板填充实现差异化输出。技术价值体现在消除人工校验盲区、保障前后端契约一致性、降低运维配置风险,典型应用场景覆盖微服务接口说明、测试用例推导、生产部署核查等工程闭环环节。Trae Solo模式正是这一理念的落地实践,它以本地化、零上传、强上下文感知为特征,深度融合Rust高性能解析与YAML驱动的语义渲染,真正实现‘代码即文档 阅读详情

相关推荐

如何用 OBProxy 实现 OceanBase 的最佳路由策略

本文基于业务中一类常见的路由问题展开,对OceanBase的路由功能及对应配置项做详细介绍,指导用户在业务实践中如何正确的配置路由策略及快速排查路由问题

OceanBase分布式数据库的博客 1699

postman使用@RequestBody的方式传递两个List<String>集合

1.封装参数 @Data public class MemberTagRelationQo implements Serializable { private List<String> memberIds = new ArrayList<>(); private List<String> tagIds = new ArrayList<>(); } 2.测试代码 @PostMapping("save") public Object

hecr_mingong的博客 8528

给排水工程师的SWMM初体验:从软件界面到第一个简单模型的保姆级上手教程

本文为给排水工程师提供SWMM软件的保姆级上手教程,从界面解析到创建第一个简单模型,详细介绍了SWMM的核心功能和操作步骤。通过30分钟的实践指导,帮助新手快速掌握雨水管网建模的基本技能,提升工作效率。

weixin_28736355的博客 323

@RequestBody List<Stirng> param 在postman中怎么传参

因为参数parameter本身是一个字段,不是一个对象,所以这样会校验不通过。

琉璃的博客 3529

<202505高项>《【VIP合集】 软考高项(第四版)十大知识域、五大过程组、ITTO输入输出工具、项目绩效域》

软考高项(第四版)十大知识域、五大过程组、ITTO输入输出工具、项目绩效域

Else 的博客 1861

手把手教你用Wireshark国密版分析TLCP和IPSec协议(附下载地址)

本文详细介绍了Wireshark国密版在TLCP和IPSec协议分析中的实战应用,包括环境配置、协议解析、合规性检查及高级分析技巧。该工具针对商用密码算法(如SM2/SM3/SM4)进行了专项优化,支持GB/T 38636-2020 TLCP和GB/T 36968-2018 IPSec VPN等国家标准,帮助开发者与安全工程师高效完成密评分析任务。

weixin_29325955的博客 555

根据springboot后端接口参数@RequestBody List<String> list 生成前端数据样例,仔细检查,不要犯错...

前端数据样例: {"list": ["item1", "item2", "item3"] } 注意: 数组中的项目可以根据实际情况更改。

weixin_42613018的博客 716

零基础学习simulink-- 基于自适应模糊PID控制的直流电机速度控制系统

通过上述代码实现,您可以逐步创建和搭建一个基于自适应模糊PID控制的直流电机速度控制系统。该系统能够根据电机的状态和误差实时调整PID参数,确保电机速度稳定在设定范围内。自适应模糊PID控制具有较强的鲁棒性和适应性,能够在存在不确定性和扰动的情况下提供快速且精确的控制性能。Simulink提供了强大的建模和仿真工具,使得控制系统工程师能够快速构建复杂的控制算法,并将其应用于实际工程中。直流电机建模:建立直流电机的动态模型,包括电枢电压、电流、转速和负载扭矩。自适应模糊PID控制器设计。

amy_mhd的博客 414

使用多个 @RequestBody 接收参数传递给 Controller

在一个 Controller 提供的接口中,使用多个 @RequestBody 注解接收参数

思想累积的博客 1万+

【深度学习新浪潮】李飞飞团队VAGEN框架深度解析:让VLM智能体学会“三思而后行“

VAGEN框架的真正价值,不仅在于性能指标的突破,更在于重新定义了VLM智能体的发展方向——人工智能的进步不应只追求"做得对",更要实现"想得清"。李飞飞团队通过强制显式思考、动态表示适配和精细化奖励三大创新,让智能体第一次具备了可解释的世界建模能力。正如人类通过"观察-预测-行动"认识世界,VAGEN为AI注入的这种思考范式,或许正是通往通用人工智能的关键一步。对于开发者而言,开源的VAGEN框架不仅提供了强大的工具,更揭示了一个重要理念:让AI学会思考,比让它学会执行更重要。

专注:太空算力、AI infra、异构调度、大模型成本工程 282

中国工商银行企业架构建设实践最全总结

中国工商银行参考IBM持续价值创新方法并吸收TOGAF等主流企业架构的框架理念,结合业务实际情况形成工行自己的企业架构方法论并实践,为数字化转型提供支撑。本案例通过介绍中国工商银行企业架构之业务架构设计方法,为其他银行企业架构建设提供参考。 企业架构是数字化转型的抓手,可以帮助企业规划、管理和实施数字化解决方案,以实现业务目标并适应不断变化的市场条件。中国工商银行通过战略目标指导业务架构的规划和设计,业务架构建模后指导IT架构建模。

银行信息系统应用架构详解 2736

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

点击上方“Java精选”,选择“设为星标”别问别人为什么,多问自己凭什么!下方有惊喜,留言必回,有问必答!每一天进步一点点,是成功的开始...目录@RequestBody 概述接收单个 String 参数接收 字符串数组 参数接收 List 参数接收整形数组接收单个 POJO 对象接收 POJO List 参数@Deprecated 标记废弃方法@RequestBody概...

Java精选 1071

教你写出高质量SQL(实践必备)

1、查询SQL尽量不要使用select * ,而是select具体字段。 //反例子 select * from sys_user; //正例子 select id,name from sys_user; 理由: 只取需要的字段,节省资源、减少网络开销;select * 进行查询时,很可能就不会使用到覆盖索引,就会造成回表查询; 覆盖索引:只需要在一棵索引树上就能获取SQL所需的所有列数据,无需回表,速度更快。 例如: 回表查询:先通过普通索引的值定位聚簇索引值,再通过聚簇索引的值定位行记..

ANGEL CITY 9996

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

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

LoveSummer 7697

最新的sdio 4.0 spec 协议标准 带书签 高清完整PDF版

Part-E1-SDIO-Specification-Ver4.00-Final-120220.pdf:最新的sdio 4.0 spec 协议标准 带书签 高清完整PDF版,包括SDIO 接口的外设,SDIO 接口官方协议等。

Camera2Demo

在Camera2 的基础上进行封装,使得Camera2一堆初始化逻辑与Activity分离,降低耦合度,完成预览拍照并保存的操作

JAVA注解大全(个人复习不断增加)

以前,XML是各大框架的青睐者,它以松耦合的方式完成了框架中几乎所有的配置,但是随着项目越来越庞大,XML的内容也越来越复杂,维护成本变得越来越高。 于是就有人提出来一种标记式高耦合的配置方式,注解。方法上可以进行注解,类上也可以注解,字段属性上也可以注解,反正几乎需要配置的地方都可以进行注解。 关于注解和XML两种不同的配置模式,争论了好多年了,各有各的优劣,注解可以提供更大的便捷性,易于维护修改,但耦合度高,而 XML 相对于注解则是相反的。 追求低耦合就要抛弃高效率,追求效率必然会遇到耦合。本文意不再

淡若清风 5563

IEM模型,地表粗糙度模拟

利用微波反演土壤水分时候,利用IEM模型可以实现对随机地表的模拟

Spring面试深度解析:IoC、AOP、事务与Boot 3.x实战原理

Spring框架是Java企业级开发的核心基础设施,其本质是一套基于IoC(控制反转)和AOP(面向切面)的轻量级容器设计范式。理解其底层原理需从Bean生命周期管理、动态代理机制、事务传播行为等基础概念切入——这些不仅是面试高频考点,更是微服务架构中稳定性与可维护性的技术基石。例如,@Transactional失效往往源于对Spring代理模型与线程上下文隔离的认知盲区;而Spring Boot自动配置的‘魔法’实为条件化Bean注册的工程实践。结合Spring Boot 3.x的Jakarta EE迁移

weixin_34416754的博客 383

温度PID控制PLC程序

温度PID稳定控制程序,适用于欧姆龙PLC,对其他PLC也具有很大参考价值

Spring Security 6.x 从入门到实践:Lambda DSL与JWT认证详解

在Java Web开发中,应用安全是构建可靠系统的基石,其核心在于认证与授权两大机制。认证负责验证用户身份,授权则控制资源访问权限。Spring Security作为Spring生态的标准安全框架,通过基于Servlet Filter的链式处理模型实现这些功能,为应用提供全面保护。随着Spring Security 6.x的发布,其引入了基于Lambda的DSL配置方式,显著提升了配置的声明性与可读性,让开发者能更直观地定义安全规则,降低了工程实践中的配置复杂度。结合现代前后端分离架构,采用JWT(JSON

diaohong5075的博客 345

Java注解原理与高级应用全解析

Java注解(Annotation)作为元数据编程的核心技术,通过编译器检查和运行时反射实现声明式开发。其底层原理基于接口动态代理,配合@Target、@Retention等元注解控制作用范围与生命周期。在Spring、JPA等主流框架中,注解大幅简化了配置工作,典型应用包括依赖注入(@Autowired)、ORM映射(@Entity)和AOP切面(@Aspect)。开发自定义注解时需注意反射性能开销,可通过注解处理器(AbstractProcessor)实现编译期代码生成。随着Java生态发展,注解在微服

weixin_34391445的博客 319
上一篇: 一次SQL查询优化原理分析:900W+数据,从17s到300ms
下一篇: 自从上了Prometheus,睡觉真香!
公众号-芋道源码
博客等级 码龄10年 1639粉丝 377原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值