Swagger2 生成離線文件HTML或PDF
阿新 • • 發佈:2018-12-21
由於專案需要,這幾天一直在研究如何用swagger生成離線文件,網上也有許多如何解決該問題的方案,很多解決方案都只針對某一個類進行生成文件,這個工作量還不如手動去寫文件,直到我看了如下的程式碼....
主要參考如下程式碼:
按照上述程式碼引入相關包後,本地環境仍然會遇到如下問題:
1.啟動test命令後無法生成swagger.json檔案。
2.生成的文件內容不完整。
上述問題1的現象如下:
原因如圖所示,調過了test命令,後來發現在依賴包中用如下的引入:
<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-surefire-plugin</artifactId> <version>2.19.1</version> <configuration> <skipTests>true</skipTests> <!--預設關掉單元測試 --> </configuration> </plugin>
原本只是想改為false就可以了,但是該依賴的引入已經在第三方包中存在,無法進行修改
解決辦法:在目前本地的pom檔案中再加一個同樣的依賴覆蓋父類中的依賴
<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-surefire-plugin</artifactId> <version>2.19.1</version> <configuration> <skipTests>false</skipTests> <!--開啟單元測試 --> </configuration> </plugin>
問題2 的原因在於,原來下載下來的index.adoc檔案中顯示如下:
中括號換行了,導致最後一個檔案沒有被載入進來,將中括號改回同一行即可“[]”