Swagger 是一个用于生成、描述和调用 RESTful 接口的 web 服务。通俗的来讲,
Swagger 就是将项目中所有(想要暴露的)接口展现在页面上,并且可以进行接
口调用和测试的服务。
Swagger 3.0 于 2020.7 月发布,但目前市面上使用的主流版本还是 Swagger 2.X
版本和少量的 1.X 版本。微服务架构升级使用最新版本的 Swagger3.0。
Swagger 有以下 3 个重要的作用:
1) 将项目中所有的接口展现在页面上,这样后端程序员就不需要专门为前端使用
者编写专门的接口文档;
2) 当接口更新之后,只需要修改代码中的 Swagger 描述就可以实时生成新的接
口文档了,从而规避了接口文档老旧不能使用的问题;
3) 通过 Swagger