【问题标题】:openapi tools generator vs swagger codegenopenapi 工具生成器 vs swagger 代码生成器
【发布时间】:2020-02-17 08:06:40
【问题描述】:

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

swagger-codegen-cli

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

openapi 工具生成器

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

谁能告诉我,这两个工具是否相互关联?哪一个是最新版本?

【问题讨论】:

    标签: swagger swagger-codegen openapi-generator


    【解决方案1】:

    来自OpenAPI Generator FAQs

    Swagger Codegen 和 OpenAPI Generator 有什么区别?

    Swagger Codegen 由 SmartBear 驱动,而 OpenAPI Generator 由 由社区推动。 40 多个顶级贡献者和模板 Swagger Codegen 的创建者已加入 OpenAPI Generator 作为 创始团队成员。更多详情,请参阅 Fork Q&A。

    Swagger 是 SmartBear 拥有的商标,该术语的使用 本项目中的“Swagger”仅用于演示(参考)目的。

    【讨论】:

      【解决方案2】:

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

      例如OpenAPI GeneratorSwagger Codegen.

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

      【讨论】:

        【解决方案3】:

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

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

        更新:

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

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

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

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

        【讨论】:

        • 从那时起,我最终编写了自己的生成器。实际上,如果有人需要以特定格式生成某些内容,请随时与我联系。
        【解决方案4】:

        了解区别的最简单方法是:

        OpenAPI = 规范。

        Swagger = 实施规范的工具。

        OpenAPI 和 Swagger 都有开源社区,欢迎所有贡献者加入,分享他们的想法并参与其中。

        【讨论】:

        • 这不是 OP 所要求的。他问的是 Swagger 和 OpenAPI 代码生成器之间的区别,而不是一般的 OpenAPI 和 Swagger。
        • @rattaman,尽管如此,这个答案确实非常重要,因为它阐明了项目的总体方向并有助于恢复对标准的信心,而不是让人们对原因感到沮丧如此多的核心开发人员和贡献者决定分叉。
        猜你喜欢
        • 2020-02-10
        • 1970-01-01
        • 2020-04-19
        • 2018-03-02
        • 2019-08-30
        • 2021-07-12
        • 2017-02-24
        • 1970-01-01
        • 1970-01-01
        相关资源
        最近更新 更多