概述
日常的项目开发中无论是前端还是后端都会跟接口文档打交道,每一个开发者都期望有一个好的接口文档,但是实际开发过程中大家没少被接口文档折磨,前端抱怨后端给的接口文档不符合实际情况,后端觉得接口文档的编写和维护太麻烦,会浪费很多精力,故而不能做到实时的更新文档.为了解决这个痛苦于是有了swagger.swagger是一套对接口定义的规范,开发者只有按照其规范定义接口和接口相关信息, 然后通过Swagger自带的一些工具,就可以生成不同格式的接口文档
Swagger简介
1.swagger提供的几种开源工具![在这里插入图片描述](https://i-blog.csdnimg.cn/blog_migrate/9a7b0be038a07f998bfc1fadc70a3ef3.png)
- Swagger Codegen:通过扫描生成的json文件,生成接口调用代码
- Swagger UI:一个可视化的UI页面展示
- Swagger Editor:Swagger描述文件的编辑器,支持实时预览描述文件的更新效果
- Swagger Inspector:类型postman的作用,可以进行接口测试
- Swagger Hub:类似github,可将描述文件上传到swagger hub上面