之前有用过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
最低0.47元/天 解锁文章
227
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
