SpringBoot实现Swagger接口响应信息自定义(二)

  上一篇SpringBoot实现Swagger接口响应信息自定义(一)讲到了实现Swagger接口响应信息自定义的初版解决方案,本篇讲述终版解决方案。

场景

  接口相关信息如路径、参数等数据可能来自枚举、模板文档、数据库等。

终版解决方案:依据swagger接口响应机制,重写swagger接口响应数据

  我们访问swagger-ui.html页面,看到的接口响应数据都是v2/api-docs接口返回的,如下图
在这里插入图片描述
  找到这个接口定义,如下图
在这里插入图片描述
在这里插入图片描述
  这里有三个关键信息,已经用红框标出,含义是从缓存中取出Documentation,转换成Swagger,最后把Swagger序列化为Json响应。
  我们可以改造这个接口,重新定义响应的Swagger,这样我们的接口信息便可以自由定义并且可以开放接口,动态控制接口响应的信息。即在最后把Swagger序列化为Json响应之前,对Swagger进行改造,具体的处理不再贴出,这里提出需要注意的点,原则上只需要重写Swagger的paths和definitions即可,想要更准确一些,也可以把tags等也重写,不过无伤大雅了。

// TODO 处理swagger

return new ResponseEntity<Json>(jsonSerializer.toJson(swagger), HttpStatus.OK);

在这里插入图片描述

新的需求

  我们想要对自定义的接口信息进行分组,可以进行权限控制、分组查询等操作,仅仅靠上述操作是无法实现了,如何解决这个问题呢?见下一篇SpringBoot实现Swagger接口响应信息自定义(三)

  • 0
    点赞
  • 5
    收藏
    觉得还不错? 一键收藏
  • 3
    评论

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

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

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值