Swagger介绍和集成

Swagger简介

前后端分离

vue + springboot  主流前后端分离方案

后端时代：前端只用管理静态页面；html==>后端，模板引擎JSP==>后端是主力

前后端分离时代：

　　　　后端：后端控制层，服务层service，数据访问层

　　　　前端：前端控制层，视图层

　　　　　　伪造后端数据，json，已经存在，不需要后端，前端工程依旧能够跑

　　　　前后端如何交互？==> API

　　　　前后端相对独立，松耦合；

　　　　前后端甚至可以部署在不同的服务器上

 

　　产生一个问题：

　　　　前后端集成联调，前端人员和后端人员无法做到即时协商，需要尽早解决

　　　　解决方案：

　　　　首先制定schema计划，实时更新最新API，降低集成风险。

　　　　早些年：制定word文档

　　　　前后端分离：

　　　　　　前端测试后端接口：postman（以前）

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

 

　　Swagger

　　　　号称世界上最流行的API框架

　　　　RestFul Api文档在线自动生成工具==》Api文档与API定义同步更新

　　　　直接运行，可以在线测试API接口

　　　　支持多种语言：（java，php）

　　官网：https://swagger.io/

　　　　在项目使用Swagger需要使用springbox

　　　　　　1）swagger2

　　　　　　2）ui

 

　　　　Springboot集成swagger

　　　　1、新建springboot-web项目

　　　　2、导入swagger2和swagger-ui依赖　

　　　　

 

 　　　　3、编写一个Hello工程

　　　　

 

 

　　　　 4、配置Swagger==>Config

　　　　　　

 

 

　　　　　5、测试运行： http://localhost:8080/swagger-ui.html

　　　　Swagger信息、接口信息、实体类信息  和组