1. swagger简介
swagger是一款能够进行接口设计，测试和联调的开源的OAS（the OpenAPI Specification）。其github
2. 安装swagger-editer
.1 打开swagger-editer，直接进行下载：
.2. 我假设你已经安装好node，npm，并且是合适的版本。
执行下面的命令，安装依赖，
npm install --registry=https://registry.npm.taobao.org·.3. 打开本地服务
执行下面的命令：
npm run serve-static如下：
我们便可以愉快的写YAML了。有很多图形化编辑工具，可以百度。
.4. 生成json，备用
2. 安装swagger-codegen
1 . 下载swagger-codegen
从http://central.maven.org/maven2/io/swagger/swagger-codegen-cli/2.2.2/swagger-codegen-cli-2.2.2.jar 下载类包到本地2 . 假设你已经安装好jdk8并配置好环境变量了。
使用命令进行生成
java -jar swagger-codegen-cli-2.2.2.jar generate -i swagger.json -l spring -o H:\spring
-jar 指定 swagger-codegen-cli-2.2.2.jar 的位置，绝对路径、相对路径均可；
-i 指定 swagger.json 的位置，本地路径、网络路径均可；
-l 指定客户端代码的语言；
-o 指定代码生成的位置；
--model-package 指定model代码的包名；
--api-package 指定api代码的包名；
于是我们的接口工程便新鲜出炉了：
- 3 .让程序跑起来。
执行mvn install安装spring依赖，用idea打开，进行后续的开发
3.安装swagger-ui
- 下载githubswagger-ui中的dist拷贝到刚刚生成的目录resources下：
- 2 . 修改pom文件
在pom中添加下面的依赖,注意需要修改版本到自己支持的
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.2.2</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.2.2</version>
</dependency>
最终启动后访问:
http://127.0.0.1:8080/swagger-ui.html便可以看到：
借用[小莫](https://xiaomo.info/)的图片
于是我们就可以测试自己的接口
