集成Swagger与Spring Boot2实现接口文档可视化

# 1. 简介

## 1.1 Swagger与Spring Boot2的概述
Swagger是一个用于设计、构建、文档化和使用RESTful风格的Web服务的开源项目。它提供了一套简洁的界面和工具，可以让开发者轻松地创建、共享和管理API文档。而Spring Boot2是一个用于简化Spring应用开发的框架，它提供了一套开箱即用的配置，使得开发者能够快速搭建和部署Spring应用。

## 1.2 目标与意义
集成Swagger与Spring Boot2可以实现接口文档的可视化，为开发者提供一个方便的方式来查看和测试接口。通过Swagger的注解和配置，可以轻松地定义和生成接口文档，并且无需手动编写文档。对于团队协作开发来说，接口文档的可视化可以提高开发效率，减少沟通成本。同时，接口文档的可视化还可以方便前端开发人员进行接口调用的测试和调试。
## 2. 配置Swagger到Spring Boot2项目

在这一章节中，我们将会讲解如何将Swagger集成到Spring Boot2项目中，并进行相应的配置。

### 2.1 导入Swagger依赖

首先，在`pom.xml`文件中添加以下依赖：

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>3.0.0</version>
    <scope>compile</scope>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>3.0.0</version>
    <scope>compile</scope>
</dependency>

上面的依赖中，`springfox-swagger2`是Swagger的核心库，`springfox-swagger-ui`是Swagger的UI组件，用于可视化展示接口文档。

### 2.2 配置Swagger2

在Spring Boot2项目的配置文件（如`application.yml`或`application.properties`）中，添加以下Swagger相关的配置：

swagger:
  enabled: true
  title: My API Documentation
  description: This is a sample API documentation
  version: 1.0.0
  contact:
    name: Your Name
    email: your-email@example.com
    url: your-website-url.com

上述配置中，`enabled`用于指定是否开启Swagger功能；`tit