news 2026/4/23 14:33:28

swagger 接口参数字段错误

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
swagger 接口参数字段错误

swagger 接口参数字段错误

后端的接口需要使用@Vaild注解进行入参的校验,通常可以在实体类Entity的字段上加上校验注解,例如@Blank校验字段不能为空。如果多个接口都需要使用校验的话,可以用分组校验功能,但是如果接口变多的话,实体类字段上就会显得特别乱。

我的做法是每个Controller对应一个Request类,每个接口入参使用Request的静态内部类,集成实体类,并重写需要校验的get方法。Entity、Request类示例如下
Entity

@EqualsAndHashCode(callSuper=true)@DatapublicclassProcessingParameterextendsBaseEntity<ProcessingParameter>{privateStringparamCode;privateStringparamName;privateStringspec;privateStringproduct;privateStringprocess;privateStringpath;privateStringunit;}
publicclassProcessingParameterRequest{publicstaticclassInsertRequestextendsProcessingParameter{@NotBlank@OverridepublicStringgetParamCode(){returnsuper.getParamCode();}@NotBlank@OverridepublicStringgetParamName(){returnsuper.getParamName();}@NotBlank@OverridepublicStringgetSpec(){returnsuper.getSpec();}// ...}publicstaticclassUpdateRequestextendsProcessingParameter{@NotBlank@OverridepublicStringgetId(){returnsuper.getId();}@Null(message="不允许修改参数的单位")@OverridepublicStringgetUnit(){returnsuper.getUnit();}@Null(message="不允许修改Code")@OverridepublicStringgetParamCode(){returnsuper.getParamCode();}}}

但是在swagger中,接口的参数,和实际的根本不对应,网上查询的都说是springfox对重写get支持不好,升级到springdoc以及其他方法,都试了还是解决不了问题。

后来我发现,swagger页面链接到的/v2/api-docs中,发现同名InsertRequest的引用有很多处,这时我才发现,或许是因为类同名了,所以swagger接口文档参数生成的有问题,实际上可能所有的使用了XXXX.InsertRequest 的接口都会遇到这个情况,虽然内部类所在的类是不一样的,但是都叫做InsertRequest。

于是我给每个Request类中的每个静态内部类都加上了注解,并且注解中的value名都各不相同

@ApiModel(value="ProcessingParameterRequest.InsertRequest",description="新增-参数")

于是问题就解决了

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/4/23 10:08:26

科研绘图 | PSO-LSTM粒子群优化长短期记忆神经网络模型结构图

PSO-LSTM 模型是将 粒子群算法 (Particle Swarm Optimization, PSO) 与 长短期记忆网络 (Long Short-Term Memory, LSTM) 相结合的优化架构。1. 核心组成部分 LSTM (预测器) LSTM 是一种特殊的循环神经网络&#xff0c;擅长处理和预测时间序列中间隔较长的重要事件。但 LSTM 的…

作者头像 李华
网站建设 2026/4/23 12:58:39

城市数字治理中的大模型应用架构:以上海云宇星空大模型为例

当下&#xff0c;政务大模型的落地路径&#xff0c;正在分化出两条截然不同的跑道&#xff1a;当不少地方政府选择以“轻量化”的方式&#xff0c;将DeepSeek等通用模型快速接入政务系统时&#xff0c;上海市规划和自然资源局给出了一条更“重”、更深的路线。近日&#xff0c;…

作者头像 李华
网站建设 2026/4/17 19:09:50

2025最新!10个AI论文网站测评:本科生毕业论文救星大公开

2025最新&#xff01;10个AI论文网站测评&#xff1a;本科生毕业论文救星大公开 2025年AI论文写作工具测评&#xff1a;精准匹配本科生需求 随着人工智能技术的不断进步&#xff0c;越来越多的学术辅助工具进入高校师生的视野。对于本科生而言&#xff0c;撰写毕业论文不仅是学…

作者头像 李华
网站建设 2026/4/23 1:37:29

Perfecxion.ai发布:生产级安全编程数据集防范AI代码漏洞

这项由Perfecxion.ai公司的Scott Thornton领导的研究于2025年12月发表在arXiv预印本服务器上&#xff0c;论文编号为arXiv:2512.18542v1&#xff0c;有兴趣深入了解的读者可以通过该编号查询完整论文。想象你正在厨房里跟着一个看起来经验丰富的厨师学做菜。这位厨师动作娴熟&a…

作者头像 李华