Swagger

学习目标：

• 了解Swagger的作用和概念
• 了解前后端分离
• 在SpringBoot中集成Swagger

douSwagger简介

前后端分离

Vue + SpringBoot 前后端主流解决方案

后端时代：前端只用管理静态页面：html ;后端，模板引擎 JSP，后端把前端的事基本上都包了，啥都干。

前后端分离式时代

• 后断：后端控制层、服务层、数据访问层 {后端团队}
• 前端：前端控制层、视图层  {前端团队}    

           伪造后端数据，json.已经存在了，不需要后端，前端工程依旧可以跑起来

• 前后端如何交互---API
• 前后端相对独立，松耦合；
• 前后端甚至可以部署在不同的服务器上；

产生一个问题：

• 前后端集成联调，前端人员和后端人员无法做到“即时协商，尽早解决”，最终导致问题集中爆发；

解决方案：

• 首先指定schema[计划的提纲]，实时更新最新API，降低集成的风险；
• 早些年，制作word计划文档
• 前后端分离：

            前端测试后端接口：postman

             后端提供接口，需要实时更新最最新的消息及改动

 

Swagger

• 号称世界上最流行的API框架
• RestFul APi 文档在线自动生成工具=》API文档与API定义同步更新
• 直接运行，可以在线测试API接口；
• 支持多种语言（java,php）

官网：swagger

在项目中使用swagge需要springfox;

•  swagger2
• ui

总结：

1.我们可以 通过Swagger给一些比较难理解的属性或者接口，增加注释信息

2.接口文档可以实时更新

3.可以在线测试

Swagger是一个优秀的工具，几乎所有大公司都有使用它

{注意点}在正式发布的时候，关闭Swagger!!! 出于安全考虑，而且节省运行