该项目的作用是根据swagger在线api生成离线api文档。
- 只适用于集成swagger框架的项目
- 确保项目的
/v2/api-docs接口可访问 - 目前离线文档只支持
html5格式，如果需要转化为doc或pdf格式，可以将生成的html5文件选择用world文档打开，然后选择'另存为'其他格式。（建议采用html格式，效果最好）
- 1.通过http请求访问swagger相关接口：
/v2/api-docs,将获取到的json数据保存至项目的target/asciidoc目录下，文件名为swagger.json； - 2.读取上步中保存的
swagger.json文件，转换为html形式的接口文档。
该项目不需要运行任何程序，只需要修改SwaggerExportTest.java文件，然后执行相关mvn命令即可。
该项目主要类只有一个，包括配置也是在该类中配置，即:
src\test\java\com\beauxie\swagger\export下的SwaggerExportTest.java测试类
- 配置URL
修改服务器地址,比如api接口访问地址为
http://127.0.0.1:8080/v2/api-docs,则如下配置:
/**
* 服务器地址
*/
private static String SERVICE_URL = "http://127.0.0.1:8080";- 生成文档
修改url地址以后，在项目根目录下打开cmd命令窗口，执行以下mvn命令:
mvn test
- 文件位置
执行成功以后，会在项目的
target/asciidoc/html目录下，生成一个名为index.html文件，这个文件就是swagger离线api文档，用浏览器打开即可查看。