SpringMVC集成Swagger：为SpringMVC项目生成API文档

## 1. 引言
### 1.1 什么是SpringMVC
Spring MVC是Spring框架的一部分，用于构建Web应用程序的模型-视图-控制器，提供了一种代码组织方式，以及定义请求和处理请求的方式。

### 1.2 什么是Swagger
Swagger是一个用于设计、构建、记录和使用RESTful API的工具。它包括一系列规范和工具，可以帮助开发人员更容易地设计、构建和使用RESTful服务。

### 1.3 为什么需要集成Swagger
集成Swagger可以帮助开发人员轻松生成API文档，提供可视化的界面展示API信息，并且可以方便地测试API接口，提高开发效率，减少开发人员之间的沟通成本。

## 2. SpringMVC与Swagger的集成准备
### 2.1 添加Swagger依赖
首先在Maven或Gradle配置文件中添加Swagger的依赖，以引入Swagger相关的库和工具，例如：

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

### 2.2 配置Swagger的注解扫描
在SpringMVC的配置类中，使用`@EnableSwagger2`注解启用Swagger，并配置注解扫描路径，例如：

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
            .select()
            .apis(RequestHandlerSelectors.basePackage("com.example.controller"))
            .paths(PathSelectors.any())
            .build();
    }
}

### 3. 配置Swagger的持久化

在集成Swagger后，我们可以选择将API文档持久化到不同的形式，以便于查看和分享。

#### 3.1 使用Swagger的UI界面

Swagger提供了一个直观的UI界面，可以展示API的详细信息和调试功能。配置Swagger的UI界面非常简单，只需添加相应的依赖和配置。

首先，需要在项目的pom.xml文件中添加Swagger UI的依赖：

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>${swagger.version}</version>
    <scope>compile</scope>
</dependency>

然后，在SpringMVC的配置类中添加Swagger UI的配置：

@Configuration
@EnableSwagger2
public class SwaggerConfig {

    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.example"))
                .paths(PathSelectors.any())
                .build()
                .apiInfo(apiInfo());
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("My API Documentation")
                .description("This is a sample API documentation")
                .version("1.0")
                .build();
    }
}

在以上代码中，我们使用`.apis(RequestHandlerSelectors.basePackage("com.example"))`指定了扫描的包路径，根据实际情况进行调整。

接下来，启动Spring Boot应用程序，并访问`http://localhost:8080/swagger-ui.html`，可以看到Swagger UI界面，其中包含了我们编写的API文档，以及可交互的测试功能。

#### 3.2 使用Swagger的JSON文件

如果希望将API文档以JSON文件的形式进行持久化，Swagger也提供了相应的支持。

首先，需要在SpringMVC的配置类中添加Swagger JSON的配置：

@Configuration
@EnableSwagger2
public class SwaggerConfig {

    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.example"))
                .paths(PathSelectors.any())
                .build()
                .a