openapi 工具生成器与 swagger 代码生成器

Question

我迷失在依赖项和工具中：我以前使用以下工具为我的 swagger webservices 生成代码。

招摇-codegen-cli

• https://mvnrepository.com/artifact/io.swagger.codegen.v3/swagger-codegen-cli/3.0.13
• https://github.com/swagger-api/swagger-codegen

然后我注意到了以下工具，并认为这是继任者：

openapi 工具生成器

• https://github.com/OpenAPITools/openapi-generator
• https://openapi-generator.tech/docs/installation.html

但是生成的代码使用了不同的注释并且看起来更旧。

有人能告诉我，这两个工具是否相互关联，哪个是最新版本？

Answer 1

来自OpenAPI 生成器常见问题解答

Swagger Codegen 和 OpenAPI Generator 有什么区别？

Swagger Codegen 由 SmartBear 驱动，而 OpenAPI Generator 由社区驱动。超过 40 位 Swagger Codegen 的顶级贡献者和模板创建者已加入 OpenAPI Generator 作为创始团队成员。有关更多详细信息，请参阅 Fork 问答。

Swagger 是 SmartBear 拥有的商标，本项目中使用的术语“Swagger”仅用于演示（参考）目的。

Answer 2

看来openapi目前处于一个混乱的状态。我也对使用哪个生成器感到困惑......而且我想编写一个自定义生成器。

GRPC 的状态要好得多。每个生成器都是一个插件，核心维护良好，社区没有分叉。

更新：

我们公司已同意继续使用 OpenAPI。我们现在使用 OpenAPI 的新 OpenSource 变体：openapi-generator.tech/

我们扩展了 python 生成器来调整生成的代码。我们还在 TypeScript 中使用客户端生成器，并考虑将 Kotlin 和 Swift 用于我们的移动应用程序。

最终效果很好。如果您还没有准备好使用 GRPC 进行二进制处理，OpenAPI 是一个不错的选择。它确实需要更多一点，我对 GRPC 的经验是它是一个无需大脑的解决方案。“它就是有效”。

但您的里程可能会有所不同。

Answer 3

比较开源项目的一种方法是使用https://openhub.net。

例如OpenAPI 生成器与Swagger Codegen。

从活动和社区图表来看，openapi-generator 似乎更加活跃。