一、简介
在当下这个前后端分离的技术趋势下，前端工程师过度依赖后端工程师的接口和数据，给开发带来了两大问题：
- 问题一、后端接口查看难：要怎么调用？参数怎么传递？有几个参数？参数都代表什么含义？
- 问题二、返回数据操作难：数据返回不对或者不够怎么办？怎么才能灵活的操作数据？
这是很多公司前后端分离之后带来的困扰，那怎么来解决这些问题？
问题一的一般解决方案：后端团队共同维护一个在线文档，每次改接口再去改对应的文档，但难免会遗漏，花的大力气但却效果平平。
问题二的一般解决方案：自己搭建一个Mock服务器，然后一个接口一个接口手动去录规则，还是一个费力的体力活。
那有没有最优的解决方案，来解决以上两个问题呢？答案是肯定的，那就是将要登场的“Swagger”和“Easy Mock”。
1.1 Swagger介绍
Swagger是全球最流行的接口文档自动生成和测试的框架，几乎支持所有的开发语言。
Swagger官网地址：https://swagger.io/
1.2 Easy Mock介绍
Easy Mock是一个可视化，并且能快速生成 模拟数据 的持久化服务。
Easy Mock能一键导入Swagger所有接口，省去了手动录制接口的麻烦，而且能够完美的适配Swagger中的代码注释，可谓开发利器。
Easy Mock数据是保存在云端的，而且可以创建团队项目，可以真正的实现前端脱离后端进行项目开发。
接下来一起来看看怎么在项目中集成Swagger和Easy Mock吧。
1.3 开发环境
- JDK 8
- Spring Boot 2.0.4
- Swagger 2.9.2
- IDEA 2018.2
二、Swagger集成
本文介绍的Swagger是基于Spring Boot框架的，一起来看具体的实现步骤。
2.1 添加依赖
配置pom.xml，添加如下代码：
<dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.9.2</version> </dependency> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>2.9.2</version> </dependency>其中：
- springfox-swagger2 用于JSON API文档的生成；
- springfox-swagger-ui 用于文档界面展示。
更多版本请访问：
springfox-swagger2：http://mvnrepository.com/artifact/io.springfox/springfox-swagger2
springfox-swagger-ui：http://mvnrepository.com/artifact/io.springfox/springfox-swagger-ui
2.2 注册Swagger
在源码的根目录也就是Appliction.java的同级目录，创建Java类“SwaggerConfig.java”（命名无所谓），代码如下：
import org.springframework.boot.autoconfigure.condition.ConditionalOnExpression; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import springfox.documentation.service.ApiInfo; import springfox.documentation.spi.DocumentationType; import springfox.documentation.spring.web.plugins.Docket; import springfox.documentation.swagger2.annotations.EnableSwagger2; import static springfox.documentation.builders.PathSelectors.regex; @Configuration @EnableSwagger2 @ConditionalOnExpression("${swagger.enable:true}") public class SwaggerConfig { @Bean public Docket swaggerSpringMvcPlugin() { ApiInfo apiInfo = new ApiInfo( "Spring Boot APIs", "Spring Boot + Swagger2", "1.0.0", null, "王磊的博客", "作者：王磊", "http://www.apigo.cn/"); Docket docket = new Docket(DocumentationType.SWAGGER_2) .select() .paths(regex("/api/.*")) .build() .apiInfo(apiInfo) .useDefaultResponseMessages(false); return docket; } }其中“@ConditionalOnExpression”为Spring的注解，用户是否实例化本类，用于是否启用Swagger的判断（生产环境需要屏蔽Swagger）。
2.3 生产环境禁用Swagger
是否启用Swagger是在application.properties文件里配置的，配置如下：
swagger.enable=true
生产环境禁用，设置为false即可。
2.4 添加文档注释
完成以上三个步骤，已经完成了Spring Boot对Swagger的集成，但是文档不够友好，比如类、接口的中文说明、参数的说明，是没有的，需要在代码中完成。
如下代码：
