Swagger搭建Restful接口教程一

一、前言

Swagger 是一款RESTFUL接口的文档在线自动生成+功能测试功能软件，随着现在许多公司实现了前后端分离，swagger越来越受欢迎了。

中文官网：http://www.sosoapi.com/

二、历史版本（绝版干货）

其实swagger是有两个版本的，而且区别还挺大的，一个是swagger-ui也就是swagger1;还有一个是springfox-swagger也就是swagger2;很多人都不知道给搞混淆了，两个版本各有各得特色，本篇博客先说swagger-ui。

三、版本一（swagger-ui）

通过输入http://localhost:8080/项目跟路径/dist/index.html直接可以访问自己的页面。

我的是http://localhost:8080/swagger_springmvc/dist/index.html#/

四、准备工作

前端html下载

下载dist文件

swagger-ui版本首先需下载HTML有两种方式
第一种：从github上下载相关html ,;

https://github.com/swagger-api/swagger-ui

注意事项

如果采取第一种下载方式的话，一定要注意版本，千万不要下载最新的版本dist否则swagger-ui是不支持的。要下载2.x版本的。

详细地址：https://github.com/swagger-api/swagger-ui/tree/2.x/dist

个人建议还是从我的博客中下载吧，毕竟我已经都给弄好了。
Jar包下载

<!-- Swagger包 -->

          swagger-springmvc 1.0.2

          swagger-models 1.0.2

          swagger-annotations 1.3.11
<!-- JSON包 -->

          json-lib 2.4
<!-- JACKSON包 -->

          jackson-annotations 2.6.5

          jackson-databind 2.6.5

          jackson-core 2.6.5

注意事项

这些jar包的版本不能改变，如果版本改了很可能因为版本的原因而实现不了，说个最简单的Swagger jar包版本如果变了，很大可能就不行，这个之前博主亲自试验过。

如果你的项目是maven项目的话，那么给的建议就是将这些jar包配到自己的maven仓库。然后再pom文件里引入，就像我的这样。