swagger是什么:
官方说法:Swagger是一个规范和完整的框架,用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法,参数和模型紧密集成到服务器端的代码,允许API来始终保持同步。
个人理解:现在项目基本都采用前后端分离的方式, 后台服务器基本以接口开发方式为主。
前端以(html+js、安卓、ios),后台以java为主(接口开发形式), 这对于接口的测试和文档的要求就相对高了很多,所以这就耽误了开发进度,swagger就是一个专门的接口文档生成工具和测试工具。减少了 程序员不必要的工作量。
配置入门
1、导入maven依赖
我这里使用的springmvc4.3.8
<!--springfox的核心jar包-->
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.7.0</version>
</dependency>
<!--springfox-ui的jar包(里面包含了swagger的界面静态文件)-->
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.7.0</version>
</dependency>
<!--springfox依赖的jar包;如果你的项目中已经集成了无需重复-->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.9.0</version>
</dependency>
2、编写swagger的配置文件:
package com.xingxue.config;
import org.springframew