导出swagger2生成的文档
百度了好多篇用法,沒法用。特此記錄一下
一、下載項(xiàng)目
下載https://github.com/Swagger2Markup/spring-swagger2markup-demo下的項(xiàng)目,保存,注意文件路徑不要有中文。我們稱這個(gè)項(xiàng)目為A項(xiàng)目。
沒錯(cuò)這個(gè)項(xiàng)目就是專門根據(jù)json解析生成文檔的。
二、修改配置
解壓項(xiàng)目,并且用IDEA打開。
啟動(dòng)要生成文檔的項(xiàng)目,前提這個(gè)項(xiàng)目集成了swagger2,瀏覽?http://localhost:8080/swagger-ui.html?
輸入:http://localhost:8080/v2/api-docs?保存頁面的json數(shù)據(jù),并把這個(gè)json文件保存在一個(gè)路徑下
找到A項(xiàng)目的pom.xml修改:swagger.input>api-docs.json</swagger.input> 的值,就是你的json文件路徑,我這里是直接把這個(gè)json文件放到了A項(xiàng)目中,所以這樣寫。
三、編譯
執(zhí)行 mvn test 命令,在\target\asciidoc 找到生成的文檔
好吧這樣 HTML和 PDF 格式的文檔就生成好了,缺點(diǎn)是多層json格式解析不到。Controller下的方法都被隱藏了,有時(shí)間再研究吧。
總結(jié)
以上是生活随笔為你收集整理的导出swagger2生成的文档的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 2022-2028年中国锂电材料产业投资
- 下一篇: 2022-2028年中国离心机行业市场研