1. 程式人生 > >Swagger2 生成離線文件HTML或PDF

Swagger2 生成離線文件HTML或PDF

      由於專案需要,這幾天一直在研究如何用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檔案中顯示如下:

中括號換行了,導致最後一個檔案沒有被載入進來,將中括號改回同一行即可“[]”