我在 maven构建周期期间通过Carma swagger-生成swagger service.json 和其他 resource.jsons JAXRS-的doclet 即可。之后,我在Web服务器上部署了工件以及swagger-ui,我可以参考生成的文档。这意味着我没有在我的应用程序中部署一个招摇豆!
由于swagger主要部署在您的API实现中,我想知道swagger-ui采用哪种方法来使文档可执行。它是否从swagger-ui文档重定向到真正的实现,还是基于service.json 创建模拟后端?我已经读过可以在node.js中创建一个基于service.json的后端,但是我无法弄清楚如何在网页中做到这一点。我现在甚至不在网页内如果可能?
答案 0 :(得分:1)
Swagger-ui读取您公开的swagger规范并公开一个html应用程序,允许您执行记录的API。它不会创建后端,它使用swagger-js项目来动态读取规范并执行调用。
因此,对于基于javascript的应用程序,你有swagger-js,但是如果你想生成客户端,你可以使用swagger-codegen - https://github.com/wordnik/swagger-codegen - 它读取你拥有的规范文件,并允许你执行各种任务比如创建客户端,服务器,静态文档等。