導出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下的方法都被隱藏了,有時間再研究吧。

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章