导出swagger2生成的文档

百度了好多篇用法,没法用。特此记录一下

一、下载项目

下载https://github.com/Swagger2Markup/spring-swagger2markup-demo下的项目,保存,注意文件路径不要有中文。我们称这个项目为A项目。

没错这个项目就是专门根据json解析生成文档的。

二、修改配置

解压项目,并且用IDEA打开。

启动要生成文档的项目,前提这个项目集成了swagger2,浏览 http://localhost:8080/swagger-ui.html 

输入:http://localhost:8080/v2/api-docs 保存页面的json数据,并把这个json文件保存在一个路径下

找到A项目的pom.xml修改:swagger.input>api-docs.json</swagger.input> 的值,就是你的json文件路径,我这里是直接把这个json文件放到了A项目中,所以这样写。

三、编译

执行 mvn test 命令,在 argetasciidoc 找到生成的文档

好吧这样 HTML和 PDF 格式的文档就生成好了,缺点是多层json格式解析不到。Controller下的方法都被隐藏了,有时间再研究吧。

原文地址:https://www.cnblogs.com/zeussbook/p/11091520.html