github swagger-samples-找不到swagger.json文件

时间:2018-11-20 17:41:47

标签: swagger swagger-ui

我张贴了the following question in the Swagger Google groups,但在那儿还没有得到答复。

================================================ ======

swagger-sample会生成swagger.json吗?

我猜想swagger-samples示例程序的重点是提供小的REST实现,在其中生成swagger.json文件,您可以使用SwaggerUI程序查看该实现。如果不是,请告诉我,因为我正在尝试学习如何对基于JAX-RS的应用程序进行注释并生成OpenAPI规范,以便可以在SwaggerUI中对其进行查看。

我已经运行了两个示例:java-jersey2和java-jersey-jaxrs。

两者都可以编译并运行良好(使用Java 8)。我使用记录在案的命令:

mvn软件包-Dlog4j.configuration = file:./ conf / log4j.properties jetty:run

我打开浏览器到http://localhost:8002,然后看到对话框(请参见附件),仅此而已。我不确定从那里去哪里。

我尝试在输入字段中输入不同的值,但是“浏览”链接除了刷新页面外什么也不做。我检查了页面上的javascript以了解这一点。

另外,我已经了解了SwaggerUI的工作方式。我还为其余端点之一手动创建了swagger.json文件,并验证了它是否可以使用SwaggerUI正常工作,但尚未(尚未)弄清楚如何从注释中创建OpenAPI规范(aka swagger.json)文件,所以我开始了解这些内容。

有两个问题:

  1. 这些示例是否生成Swagger.json文件?如果是这样,它在哪里(我搜索但没有找到它)。

  2. 如果没有,生成该swagger.json文件的下一步是什么,这样我可以在正在运行的SwaggerUI实例中指向它。

================================================ ======

我可以看到我并不孤单地使用开源解决方案创建swagger.json文件。这是我使用过的其他一些问题和资源:

0 个答案:

没有答案