SpringBoot + mybatis + Swagger快速构建REST API并生成优美的API文档

Spring Boot能够快速开发、便捷部署等特性，相信有很大一部分Spring Boot的用户会用来构建REST API。
我们构建RESTful API的目的通常都是由于多终端的原因，这些终端会共用很多底层业务逻辑，因此我们会抽象出这样一层来同时服务于多个移动端或者Web前端。这样一来，我们的RESTful API就有可能要面对多个开发人员或多个开发团队：IOS开发、Android开发或是Web开发等。为了减少与其他团队平时开发期间的频繁沟通成本，我们可以创建一份RESTful API文档来记录所有接口细节。

Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。
Swagger UI允许任何人 - 无论是您的开发团队还是最终消费者 - 可视化并与API资源进行交互，而无需执行任何实施逻辑。它是从您的Swagger规范自动生成的，可视化文档使后端实现和客户端消耗变得容易。

git中项目的下载地址：https://gitee.com/ydn/springboot-mybatis-swagger

1、创建一个spring boot项目

在浏览器中输入start.spring.io进入快速自动创建spring boot的页面。填写对应的参数之后，点击生成，就生成了一个spring boot项目。把项目import到你的开发工具中即可(记住：是导入已存在的maven项目)。

2、在pom.xml中新增所需的依赖项

<!--连接操作mysql数据库的包-->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-Java</artifactId>
    <version>5.1.6</version>
</dependency>

<!--使用Swagger所需包-->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.2.2</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.2.2</version>
</dependency>

<!-- 整合mybatis所需依赖包 -->
<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>1.3.0</version&g