如何为 OpenAPI 3.0.0 运行 swagger-codegen答案

【问题标题】：How to run swagger-codegen for OpenAPI 3.0.0如何为 OpenAPI 3.0.0 运行 swagger-codegen
【发布时间】：2017-08-16 15:03:07
【问题描述】：

看起来像官方的swagger openapi 规范 V3 支持即将发布 https://blog.readme.io/an-example-filled-guide-to-swagger-3-2/，并且 swagger-codegen 已经开发了 3.0.0 支持，并通过了 https://github.com/swagger-api/swagger-codegen 在 3.0.0 分支上的一定程度的测试

我有一个 swagger 规范（通过 https://github.com/mermade/swagger2openapi 从我现有的 2.0 规范生成，输出看起来不错）

有没有一种简单的方法来运行 swagger-codegen 而不必自己打包 jar？

这是我找到的唯一结果：https://oss.sonatype.org/content/repositories/snapshots/io/swagger/swagger-codegen-cli/3.0.0-SNAPSHOT/，但运行似乎已损坏（从输出来看，可能实际运行的是 2.0 而不是 3.0.0？）：

[main] INFO io.swagger.parser.Swagger20Parser - 从 /input/myspec.openapi3.json 读取 [主] 信息 io.swagger.codegen.ignore.CodegenIgnoreProcessor - 找不到 .swagger-codegen-ignore 文件。线程“主”java.lang.RuntimeException 中的异常：缺少招摇输入或配置！在 io.swagger.codegen.DefaultGenerator.generate（DefaultGenerator.java:685）在 io.swagger.codegen.cmd.Generate.run(Generate.java:285) 在 io.swagger.codegen.SwaggerCodegen.main(SwaggerCodegen.java:35)

看起来 swagger-codegen repo 有一种在某种程度上受支持的方式来运行 docker 容器在你构建之后；我只是希望/猜测有一种支持的方式来执行此操作，而无需在本地编译，因为我需要在多个地方进行设置。

【问题讨论】：

hub.docker.com/r/bentheadset/bentheadset-swagger-codegen-3.0.0 拉取上面链接中发布的 .jar (oss.sonatype.org/content/repositories/snapshots/io/swagger/…)
OpenAPI 3.0 支持正在开发中。进度请参考分支（github.com/swagger-api/swagger-codegen/tree/3.0.0_enhancements）。
@WilliamCheng 你的链接失效了。
@tchrist 感谢您报告损坏的链接。我不再参与 Swagger Codegen。请参阅下面我的回答以获取更多信息。
请在 OpenAPI 3.0 规范 bcos 上使用 swagger codegen maven 插件查看这个稍新的问题，因为它有工作答案：stackoverflow.com/questions/49616529/…

标签： swagger openapi swagger swagger-codegen openapi

【解决方案1】：

OpenAPI Generator（由 Swagger Codegen 的顶级贡献者发现）支持 OpenAPI 规范 v2 和 v3。

您可以使用docker images、Java JAR (SNAPSHOT)、Brew 或npm 尝试一下。

更多关于OpenAPI Generator的信息，请参考项目的README

如果您需要任何帮助，请open an issue，我们会进行调查。

更新：第一个稳定版 3.0.0 已发布：https://github.com/OpenAPITools/openapi-generator/releases/tag/v3.0.0

【讨论】：

【解决方案2】：

Swagger-codegen 3.0.0 快照现在包含有限数量的目标，用于从 OpenAPI 3.0 定义生成代码。 https://github.com/swagger-api/swagger-codegen/issues/6598#issuecomment-333428808

还有一个代码生成引擎的替代实验实现，使用原始的 swagger-codegen 2.x 模板，用 Node.js 编写：https://github.com/mermade/openapi-codegen - 如果您的语言尚不支持，则只需一个配置文件为其创建将模板文件映射到输出。

【讨论】：