news 2026/7/30 17:51:25

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/7/23 2:44:05

EHR+AI助手:远程办公模式下HR与IT的合规协同方案

摘要&#xff1a;随着数字经济的深度发展&#xff0c;远程办公已从应急选项升级为企业运营的战略配置&#xff0c;但其带来的跨地域用工、数据流转、流程管控等问题&#xff0c;对HR与IT部门的协同合规提出了严峻挑战。EHR系统作为人力资源数字化的核心载体&#xff0c;与AI助手…

作者头像 李华
网站建设 2026/7/26 5:38:19

《jQuery UI API 文档》

《jQuery UI API 文档》 引言 jQuery UI 是一个基于 jQuery 的用户界面库,它提供了丰富的交互组件和效果,帮助开发者快速构建出具有丰富交互体验的网页应用。本文档将详细介绍 jQuery UI 的 API,包括其组件、方法和事件,旨在帮助开发者更好地理解和运用 jQuery UI。 一、…

作者头像 李华
网站建设 2026/7/27 9:05:45

还在用 Figma 画饼?我用这个平台,把原型上线从 3 天压到 3 分钟

作为一名产品经理&#xff0c;我最怕听到的话就是“这个需求排满了&#xff0c;下周吧”。一个在会议上让所有人兴奋的灵感&#xff0c;在漫长的排期和等待中&#xff0c;逐渐变得平庸和乏味。我曾经以为&#xff0c;这是无法改变的宿命。直到我发现&#xff0c;原来我可以自己…

作者头像 李华
网站建设 2026/7/29 20:25:04

夸克网盘下载不限速_在线解析站

今天教大家一招能解决夸克网盘限制的在线工具。这个工具也是完全免费使用的。下面让大家看看我用这个工具的下载速度咋样。地址获取&#xff1a;放在这里了&#xff0c;可以直接获取 这个速度还是不错的把。对于平常不怎么下载的用户还是很友好的。下面开始今天的教学 输入我给…

作者头像 李华
网站建设 2026/7/14 19:09:06

当“同时发生”成为攻击武器

概述 (Overview) 假设我们正在测试一个在线购物 Web 应用程序的安全性。这时可能会引出许多问题&#xff1a;我们能否用一张 10 美元的礼品卡支付 100 美元的商品&#xff1f;我们能否多次在购物车中应用相同的折扣&#xff1f;答案是&#xff1a;可能&#xff01;如果系统容易…

作者头像 李华