Spring Boot如何集成Swagger

要在Spring Boot项目中集成Swagger，请按照以下步骤操作：

1. 添加依赖

在你的pom.xml文件中添加Swagger和Swagger UI的依赖：

<dependencies>
    <!-- Spring Boot Starter Web, includes Spring MVC -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- Swagger Core Library -->
    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger2</artifactId>
        <version>2.9.2</version>
    </dependency>

    <!-- Swagger UI Library -->
    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger-ui</artifactId>
        <version>2.9.2</version>
    </dependency>

    <!-- Spring Boot Starter Test, includes testing utilities -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

2. 配置Swagger

创建一个新的Java类，例如SwaggerConfig.java，并添加以下代码：

import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.example.demo")) // 替换为你的包名
                .paths(PathSelectors.any())
                .build();
    }
}

这段代码会启用Swagger2，并告诉Swagger扫描指定包下的所有控制器（Controller）。

3. 创建API接口

在你的项目中创建一个简单的REST API接口。例如，创建一个名为UserController.java的文件，并添加以下代码：

package com.example.demo;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class UserController {
    @GetMapping("/users")
    public String getUser(@RequestParam(value = "name", defaultValue = "World") String name) {
        return String.format("Hello %s!", name);
    }
}

4. 访问Swagger UI

启动你的Spring Boot应用程序，然后在浏览器中访问http://localhost:8080/swagger-ui.html。你应该能看到Swagger UI界面，其中列出了你的项目中所有可用的API接口。点击任意接口，你可以查看其文档和示例请求。

现在你已经成功在Spring Boot项目中集成了Swagger。