admin管理员组

文章数量:1550528

之前有用过swagger，但是总感觉不够灵活所以最终选择放弃了。虽然能帮忙省不少下写接口文档和维护接口文档的时间，但是一样的带来了很多的不便利性，比如我的一个接口，不同场景请求参数不一样，通过swagger自动生成的文档很难方便的帮我区分出来，还有我的返回不同错误编码具有不同的业务属性，具体业务说明我很难通过swagger进行自定义。所以我之前一直喜欢用markdown写接口文档，也用过好几个第三方提供的接口文档管理工具。最近工作稍许空下来了，而且好几个同事朋友反复向我推荐swagger，乘着最近刚起一个新项目，所以准备引入swagger，也当是自我学习学习。

我们项目之前用的都是swagger2.X版本，但我使用技术一般都喜欢使用最新的，现在swagger最新版本是3.0.0，所以一不做二不休，决定把swagger从2.X升级到3.0。

 我想看我这篇文章的同学，应该都已经了解什么是swagger了吧，为了节约大家的阅读时间，我直接上正常，还不知道什么是swagger，swagger是干嘛用的， 可以自己晚上搜索，相关的资料还是很多的。

swagger3新特性

Swagger 3仍将采用JSON或YAML格式，但是使用的格式已作了一些小改动。

  • Swagger已重命名为OpenAPI。
  • 移除了@EnableSwagger2，新增springfox-boot-starter，是项目集成更贱简单。
  • 该项目正在采用Semv

本文标签： 升级到正确方式swagger

版权声明：本文标题：Swagger正确打开方式（一）Swagger2.X升级到Swagger3.X 内容由热心网友自发贡献，该文观点仅代表作者本人， 转载请联系作者并注明出处：https://m.elefans.com/xitong/1727247877a1104857.html， 本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容，一经查实，本站将立刻删除。