百度了好多篇用法,沒法用。特此記錄一下
一、下載項目
下載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 命令,在\target\asciidoc 找到生成的文檔
好吧這樣 HTML和 PDF 格式的文檔就生成好了,缺點是多層json格式解析不到。Controller下的方法都被隱藏了,有時間再研究吧。