在Linux中如何集成Swagger与Spring Boot

在Linux中集成Swagger与Spring Boot，可以按照以下步骤进行：

1. 添加依赖

首先，在你的Spring Boot项目的pom.xml文件中添加Swagger和Swagger UI的依赖。你可以使用Springfox库来实现这一点。

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

    <!-- Springfox Swagger2 -->
    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger2</artifactId>
        <version>2.9.2</version>
    </dependency>

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

2. 配置Swagger

创建一个配置类来配置Swagger。这个类需要使用@Configuration注解，并且包含一个方法来定义Swagger的Docket bean。

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
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.controller")) // 替换为你的控制器包路径
                .paths(PathSelectors.any())
                .build();
    }
}

3. 启动应用

确保你的Spring Boot应用已经启动。你可以在终端中运行以下命令来启动应用：

./mvnw spring-boot:run

4. 访问Swagger UI

一旦应用启动，你可以通过浏览器访问Swagger UI界面。默认情况下，Swagger UI的地址是：

http://localhost:8080/swagger-ui.html

5. 配置Swagger UI（可选）

如果你想要自定义Swagger UI的外观或行为，可以在application.properties或application.yml文件中进行配置。例如：

springfox.documentation.swagger.v2.path=/api-docs

6. 使用Swagger注解

在你的控制器类和方法上使用Swagger注解来提供更多的API文档信息。例如：

import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/api")
@Api(tags = "示例控制器")
public class ExampleController {

    @GetMapping("/hello")
    @ApiOperation("返回一个简单的问候语")
    public String sayHello() {
        return "Hello, World!";
    }
}

通过以上步骤，你就可以在Linux环境中成功集成Swagger与Spring Boot，并且可以通过Swagger UI界面来查看和测试你的API。