我张贴了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)文件,所以我开始了解这些内容。
有两个问题:
这些示例是否生成Swagger.json文件?如果是这样,它在哪里(我搜索但没有找到它)。
如果没有,生成该swagger.json文件的下一步是什么,这样我可以在正在运行的SwaggerUI实例中指向它。
================================================ ======
我可以看到我并不孤单地使用开源解决方案创建swagger.json文件。这是我使用过的其他一些问题和资源:
Swagger and swagger.json location-在问类似的问题。
Getting Started with Swagger-我从哪里开始学习摇摇欲坠。
Swagger Core Jersey 2.X Project Setup-这是我最初尝试开始的工作。这可能仍然是最好的方法(对于我正在尝试的操作)。 注意:就我而言,我正在尝试使用swagger-maven-plugin使swagger正常工作的Jersey2,但我的问题实际上是关于样本的问题,它们是否应该按照我解释的方式工作。 < / p>