springdoc-openapi-ui 与 openapi-generator-maven-plugin 不兼容

Posted

技术标签:

【中文标题】springdoc-openapi-ui 与 openapi-generator-maven-plugin 不兼容【英文标题】:springdoc-openapi-ui not compatible with openapi-generator-maven-plugin 【发布时间】:2021-11-09 05:11:32 【问题描述】:

我开始使用 openapi 规范 (3.0.1) 设计并使用 openapi-generator-maven-plugin (5.1.0) 生成代码,然后我使用 springdoc-openapi-ui 进行 spring boot (2.5.4 )。

我需要手动将生成代码中的大部分注释从 io.swagger.annotations.* 迁移到 io.swagger.v3.oas.annotations.* ,如此处所述https://springdoc.org/#migrating-from-springfox

我想在不手动迁移的情况下生成代码,但目前还没有找到与 springdoc-openapi-ui 兼容的生成器。

【问题讨论】:

【参考方案1】:

目前不支持 V3 注释。您可以通过覆盖 mustache 模板来做到这一点。

或者只是等待 5.3.1 版本进行以下更改:

https://github.com/OpenAPITools/openapi-generator/pull/9775

【讨论】:

以上是关于springdoc-openapi-ui 与 openapi-generator-maven-plugin 不兼容的主要内容,如果未能解决你的问题,请参考以下文章

springdoc-openapi-ui + swagger 不理解 @PathVariable required = false 标志

使用 Spring Security 启用 Swagger springdoc-openapi-ui (OpenAPI 3.0) - 无法访问 swagger-ui.html (401)

OP-TEE在HIKEY上的编译运行与测试

TrustZone OP-TEE 在 FVP 编译与测试

TypeError:“Mul”Op 的输入“y”的类型为 float32,与参数“x”的类型 int32 不匹配

OP-TEE 简易驱动编写:启动TZPC与TZPCDEP