使用@ApiModel遇到的问题如何解决

发布时间:2022-06-14 13:35:21 作者:iii
来源:亿速云 阅读:202

这篇文章主要介绍了使用@ApiModel遇到的问题如何解决的相关知识,内容详细易懂,操作简单快捷,具有一定借鉴价值,相信大家阅读完这篇使用@ApiModel遇到的问题如何解决文章都会有所收获,下面我们一起来看看吧。

@ApiModel遇到的问题

使用 swagger2 中的 @ApiModel 注解不规范遇到的 swagger 文档 错乱问题:

1. 习惯

以前使用 swagger2 时, 在出入参实体上添加注解 @ApiModel 时习惯性的添加 value = "XXX" 属性, 旧版本中一直没有发现有什么问题.

2. 遇坑

最近在使用 swagger2:2.9.2 版本时, 遇到一个问题, swagger 文档中的 入参 结构示例中的入参参数跟代码的入参对象中的字段不匹配不一致, 导致接口联调问题多

3. 排查

经过排查发现是因为 @ApiModel 直接使用不规范导致的。

经过排查发现, swagger2 是需要 value 属性在同一个服务全局中保持唯一的, swagger 会把所有的 API 中的出入参实体列在 swagger 文档的最下方, 如果存在多个实体的 @ApiModel(value = "用户信息") 注解相同, 那么 swagger 只会识别一个, 其他的 实体 会被覆盖, 不会被显示, 其他被覆盖的 实体在 API 被引用的地方在文档中会被识别的相同名称的实体 替代, 导致文档展示错乱问题

4. 解决

使用正确的用法:

@ApiModel(description = "用户信息"), 如果我们能在代码规范中保证实体名称不会重复, value 使用默认就好, 所以不再配置, 实体说明使用 description 来进行配置.

@ApiModel和@ApiModelProperty

版本

@ApiModel

属性名称数据类型默认值说明
valueString类名为模型提供备用名称
descriptionString"提供详细的类描述
parentClass<?>Void.class为模型提供父类以允许描述继承关系
discriminatorString"支持模型继承和多态,使用鉴别器的字段的名称,可以断言需要使用哪个子类型
subTypesClass<?>[]{}从此模型继承的子类型数组
referenceString&lsquo;&rsquo;指定对应类型定义和引用,覆盖指定的任何其它元数据

@ApiModelProperty

属性名称数据类型默认值说明
valueString"属性简要说明
nameString"运行覆盖属性的名称,重写属性名称
allowableValuesString"限制参数可接受的值
accessString"过滤属性
notesString"尚未使用
dataTypeString"参数的数据类型
requiredbooleanfalse是否必传
positionint0允许在模型中排序属性
hiddenbooleanfalse隐藏模型属性
exampleString"属性的示例值
readOnlybooleanfalse指定模型属性为只读,false:非只读
referenceString"指定对应类型定义的引用,覆盖指定的任何其他元数据
allowEmptyValuebooleanfalse允许传空置,false:不允许传空值

关于“使用@ApiModel遇到的问题如何解决”这篇文章的内容就介绍到这里,感谢各位的阅读!相信大家对“使用@ApiModel遇到的问题如何解决”知识都有一定的了解,大家如果还想学习更多知识,欢迎关注亿速云行业资讯频道。

推荐阅读:
  1. Highcharts使用时遇到的问题及解决方案
  2. 使用layui经常遇到的问题和解决方法

免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。

上一篇:Java中的final关键字如何使用

下一篇:SpringBoot怎么整合Druid数据源

相关阅读

您好,登录后才能下订单哦!

密码登录
登录注册
其他方式登录
点击 登录注册 即表示同意《亿速云用户服务条款》