Swagger笔记

一、什么是swagger？它的作用是什么？

swagger是如今世界上最流行的API框架。他能够直接运行，可在线测试API接口。

二、swagger的出现解决了什么问题

在swagger之前，编程进入前后端分离时代（主流：vue + springboot），这哥时代前后端分庭抗礼，后端负责控制层（controller层），服务层（service层），数据访问层（dao层）等，而前端则可以不需要后端支持，在前端伪造后台数据json。
此时的前后端相对独立，两者之间松耦合，通过API实现数据交互，因为前后端分离，所以很多时候前后端人员缺乏“即时协商，尽早解决”的问题。于是出现了文本文档控制版本的解决方案，也就是我们git控制版本，但是依旧缺乏高效，于是swagger应运而生，解决了这个问题。

三、springboot如何集成swagger

1）导入swagger2依赖

	<dependency>
		<groupId>io.springfox</groupId>
		<artifactId>springfox-swagger2</artifactId>
		<version>2.9.2</version>
	</dependency>

2）建立config包，在包下建立SwaggerConfig.java类，因为是配置类所以要加上@configuration注解表明这是一个配置类，因为是swagger配置类，所以类上加入@EnableSwagger2（自动开启Swagger）注解（注意：我记得swagger2的版本不要太高，高了之后找不到@EnableSwagger2的注解）。如下图

3）@Bean注解将Docker实例放到spring容器中。相关代码如下图：