2

我通过 Carma swagger-jaxrs-doclet在maven 构建周期中生成 swagger service.json和其他resource.jsons。之后，我将工件与 swagger-ui 一起部署在 Web 服务器上，我可以查阅生成的文档。这意味着我没有在我的应用程序中部署 swagger bean！

由于 swagger 主要部署在您的 API 实现中，我想知道 swagger-ui 采用哪种方法使文档可执行。它是从 swagger-ui 文档重定向到真正的实现，还是基于 service.json 创建一个模拟后端？我已经读到可以基于 service.json 在 node.js 中创建一个后端，但我不知道如何在网页中执行它。如果可以从网页内，我什至现在都不知道？

4

1 回答 1

1

Swagger-ui 读取您公开的 swagger 规范并公开一个 html 应用程序，该应用程序允许您执行记录在案的 API。它不创建后端，它使用 swagger-js 项目来动态读取规范并执行调用。

所以对于基于 javascript 的应用程序，你有 swagger-js，但是如果你想生成客户端，你可以使用 swagger-codegen - https://github.com/wordnik/swagger-codegen - 它读取你拥有的规范文件并允许您可以执行各种任务，例如创建客户端、服务器、静态文档等。

于 2014-10-16T17:59:55.833 回答