Debian系统Swagger配置指南

在Debian系统上配置Swagger涉及多个步骤，包括安装必要的软件包、配置API文档生成工具以及设置Swagger UI。以下是一个详细的指南：

1. 安装必要的软件包

首先，确保你的Debian系统是最新的。你可以使用以下命令更新系统：

sudo apt-get update
sudo apt-get upgrade

接下来，安装Swagger相关的软件包。Swagger通常与Spring Boot项目一起使用，因此你需要安装Spring Boot的开发工具和相关依赖。

sudo apt-get install spring-boot-devtools

2. 配置Spring Boot项目

在你的Spring Boot项目中，添加Swagger依赖。如果你使用的是Maven，可以在pom.xml文件中添加以下依赖：

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-boot-starter</artifactId>
    <version>3.0.0</version>
</dependency>

如果你使用的是Gradle，可以在build.gradle文件中添加以下依赖：

implementation 'io.springfox:springfox-boot-starter:3.0.0'

3. 生成Swagger配置文件

在项目中创建一个配置类，用于生成Swagger文档。例如：

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();
    }
}

4. 访问Swagger UI

启动你的Spring Boot应用程序后，你可以通过以下URL访问Swagger UI：

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

5. 配置Docker（可选）

如果你想在Docker容器中运行你的Spring Boot应用程序，可以按照以下步骤进行配置：

创建Dockerfile

在你的项目根目录下创建一个Dockerfile：

FROM openjdk:11-jre-slim
COPY target/demo-0.0.1-SNAPSHOT.jar app.jar
ENTRYPOINT ["java", "-jar", "app.jar"]

构建Docker镜像

在项目根目录下运行以下命令构建Docker镜像：

docker build -t demo .

运行Docker容器

构建完成后，你可以使用以下命令运行Docker容器：

docker run -p 8080:8080 demo

现在，你可以在浏览器中通过http://localhost:8080/swagger-ui.html访问Swagger UI。