为什么使用Swagger?
在Vue没有出来之前,都是前后端在一起:
- 后端用的SSM或者SSH框架
- 前端完全就是静态页面+模板引擎。例如:JSP开发久的人应该听说过,和现在的Thymeleaf、 Velocity、FreeMarker 类似
在Vue出来之后,进入真正的前后端分离时代:
- 后端依然可以是SSM架构,而现在大厂都在使用微服务SpringBoot、SpringCloud等
- 前端就独立出来了,只管呈现效果也就是是三层架构的视图层
为什么叫前后端分离呢?
分离就是各自开发自己的,互不干扰
优点:
- 前端可以不用等后端人员开发完在测试,直接就可以使用Json伪造数据测试,例如:JsonServer工具
- 可以部署在不同的服务器上
- 有新的项目可以随时拆分模块
缺点:
- 此时就需要在招专业开发前端的人员,这就是老板的事了。。。
Swagger简介:
Swagger是一个流行的API开发框架,Swagger容许用户使用Swagger编辑器描述OAS 3.0API,并使用SwaggerUI可视化并自动生成OAS 3.0中定义的API文档。
Swagger可以对整个API开发周期提供一个完整框架,解决调试过程中的各种问题,包括API设计,开发,测试,完档,并且几乎支持所有语言。
Swagger的用途来了:
问题:
前后端分离联调,前后端人员无法做到及时的调试?
当年的解决方案:
- 编写Word文档,及时更新(但是很难做到,一般容易忘记)
- 模拟测试后端接口:postman
- 后端开发完之后,提供接口,根据需求在调整
现在的解决方案:
- Api文档与API定义同步更新
- 直接运行,在线测试后端接口
- 对多种编程语言的支持
SpringBoot集成Swagger:
1.建立SpringBoot-Web项目
![552e81f8d9ce940aa0dda31cf5dbd287.png](https://i-blog.csdnimg.cn/blog_migrate/d4250b9cbbc986476df9584853e2dc43.jpeg)
![801c66a17354aa19e578e26e357c6178.png](https://i-blog.csdnimg.cn/blog_migrate/0353336767079af8c137013c13d47e43.jpeg)