当前位置: 首页 > news >正文

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="新增-参数")

于是问题就解决了

http://www.gsyq.cn/news/154192.html

相关文章:

  • 2026年信创产业全景深度剖析:利唐 i 人事、用友、红海云谁来领跑新纪元?
  • 洛谷 P2602:[ZJOI2010] 数字计数 ← 数位DP
  • 光影向善,大爱无界!第44届华鼎奖好莱坞揭晓 安吉丽娜·朱莉榜上有名
  • 支持灵活二次开发的 BI 工具首选!观远数据以开放架构赋能企业定制化需求
  • 2025HR数字化转型核心:IT驱动的人才敏捷性构建路径
  • MySQL 知识点:函数索引(Functional Index)
  • SQL学习应用工作场景(2)--执行优先级+语法顺序+保留2位小数
  • 论文救星!9款免费AI生成器1天搞定,文理医工全覆盖必备
  • cesium 根据经纬度高度进行额度补偿
  • 从概念到实践,带你彻底搞懂AI智能体
  • 《jQuery UI API 文档》
  • 完整理解乐观锁(以预定系统为例)
  • 利用SAT求解优化量子电路映射
  • 夸克网盘下载不限速_在线解析站
  • CRMEB 标准版系统(PHP)- 前端多语言开发指南
  • 高速斩拌机品牌权威测评,谁是行业真王者?搅拌机源头厂家精选实力品牌榜单发布 - 品牌推荐师
  • 跨数据源搜索的优化过程
  • 三星自研GPU剑指AI芯片霸权,2027年能否撼动英伟达?
  • 高速斩拌机厂家综合实力排行,国内有实力的搅拌机品牌怎么选择博锐满足多元需求 - 品牌推荐师
  • DeepAnaX「GEO优化分析统计系统」重磅升级:让每一份数据都通往清晰决策
  • 2025最新!研究生必备8个AI论文工具:开题报告与文献综述全测评
  • 同步通信协议(I2C协议、SPI协议、驱动OLED/EEPROM/传感器)教程,文章内容利于搜索引擎搜索,整篇文章不要有AI生成痕迹
  • 怎么渡过骑行倦怠期?
  • 学长亲荐10个AI论文平台,自考毕业论文轻松搞定!
  • Aneiang.Pa 代理池(Proxy Pool)功能与 ASP.NET Core Web API 集成实战
  • 2025终极AI论文神器:9款免费工具实测,查重<13%原创度高超靠谱!
  • 2026年AI产品经理进化论:当“业务直觉”遭遇“技术理性”
  • 碎点
  • Transformer 模型读书报告
  • AI创业心得:录视频量产技巧+广告行业价格战痛点分享