swagger-codegen-cli将v3 openapi.json转换为静态html

Question

我有一个openapi.json文件（在生成时生成），它是v3格式。我可以使用swagger-codegen-cli为swagger文档生成一个静态网站吗？

目标是在构建时同时生成apidoc.json和html。

示例CLI命令？

以下命令错误说我没有大方的输入：

java -jar ./lib/swagger-codegen-cli-2.2.1.jar generate -i src/main/resources/static/apidoc/openapi.json -l html2 -o target/generated-sources/swagger
[main] INFO io.swagger.parser.Swagger20Parser - reading from src/main/resources/static/apidoc/openapi.json
[main] INFO io.swagger.parser.Swagger20Parser - reading from src/main/resources/static/apidoc/openapi.json
Exception in thread "main" java.lang.RuntimeException: missing swagger input or config!
        at io.swagger.codegen.DefaultGenerator.generate(DefaultGenerator.java:132)
        at io.swagger.codegen.cmd.Generate.run(Generate.java:223)
        at io.swagger.codegen.SwaggerCodegen.main(SwaggerCodegen.java:36)

openapi.json文件不以“ swagger”开头。我需要转换吗？这是它的开头：

{"openapi":"3.0.1","info":{"title"

Answer 1

Swagger Codegen v。2不支持OpenAPI 3.0。您需要使用Codegen 版本3.x。

您可以从Maven Central下载最新的3.x CLI JAR：https://mvnrepository.com/artifact/io.swagger.codegen.v3/swagger-codegen-cli