swagger导出接口文档以及报错处理

本文档介绍了如何使用swagger2markup插件导出接口文档,包括添加依赖、配置json路径,以及解决json解析异常的问题。在导出过程中可能出现的json内容错误,可以通过复制正确json到本地文件,修改pom文件中的引用路径来解决。
摘要由CSDN通过智能技术生成

swagger导出接口文档以及报错处理

废话少说,开干

第一步,添加依赖

聚合项目建议添加的web层pom里,不用考虑代码上传的冲突问题,这玩意一般 只用一次,用完了删了就行

看图


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

插件的依赖swagger2markup

// A code block
 <plugin>
                <groupId>io.github.swagger2markup</groupId>
                <artifactId>swagger2markup-maven-plugin</artifactId>
                <version>1.2.0</version>
                <configuration>
                    <!--此处端口一定要是当前项目启动所用的端口  0.0-->
                    <swaggerInput>地址如下图</swaggerInput>
                    <!-- 下方文件夹地址自己新建一下文件夹-->
                    <outputDir>src/docs/asciidoc/generated</outputDir>
         
  • 2
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值