springboot将接口内容快速生成接口文档导出,swagger将api文档以表格文档导出

我们开发工作中,经常需要面对写文档的事情.后端写给前端,甲方给乙方提供技术接口文档.有时候会觉得挺麻烦.

虽然swagger已经为我们提供了不少便利,但通常对外提供文档时,人们希望接口参数等内容,是以表单形式展现的,比如:

于是我找到了将swagger转为类似这种表格参数展示的Swagger2Markup.它的使用也比较简单方便.基本可以满足需要.

下面是我对这个Swagger2Markup使用的代码地址:https://github.com/OceanBBBBbb/swaggerdoc

可以直接把这个在内网部署一套,而不必为所有项目添加Swagger2Markup..因为只要输入swagger-doc的地址,就可以导出这个项目的API文档了.

根据swagger访问路径,导出完整规范的接口文档

说明

如果只是需要嵌入已存在的swagger项目，加上maven配置，加入test里的Swagger2Doc.java修改url就可以了。
实现转换使用的是Swagger2Markup

引入Swagger2Markup

<dependency>
    <groupId>io.github.swagger2markup</groupId>
    <artifactId>swagger2markup</artifactId>
    <version>1.3.3</version>
</dependency>

这时候执行测试类内容时，通常会报一个错。如相关jar包不存，如

NoClassDefFoundError: ch/netzwerg/paleo/ColumnIds$StringColumnId

等等，官方给的解释一般是，加上：

<repositories>
    <repository>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
        <id>jcenter-releases</id>
        <name>jcenter</name>
        <url>http://jcenter.bintray.com</url>
    </repository>
</repositories>

如果没解决，我这就是这个情况，可以把上面的repositories内容改为：

<repositories>
    <repository>
        <id>spring-libs-milestone</id>
        <url>https://repo.spring.io/libs-milestone</url>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
    </repository>
    <!-- jhipster-needle-maven-repository -->
</repositories>
<pluginRepositories>
    <pluginRepository>
        <id>spring-plugins-release</id>
        <url>https://repo.spring.io/plugins-release</url>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
    </pluginRepository>
</pluginRepositories>