導出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 命令,在\target\asciidoc 找到生成的文檔

好吧這樣 HTML和 PDF 格式的文檔就生成好了,缺點是多層json格式解析不到。Controller下的方法都被隱藏了,有時間再研究吧。

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM