Swagger于Linux怎样集成开发

在Linux系统上集成Swagger进行API文档生成和测试，可以按照以下步骤进行：

1. 安装Java运行环境

Swagger依赖于Java运行环境，因此需要先安装Java。可以使用以下命令在基于Debian/Ubuntu的Linux发行版上安装OpenJDK：

sudo apt update
sudo apt install openjdk-11-jdk

2. 配置构建工具（Maven或Gradle）

根据你的项目使用的构建工具，配置相应的Swagger依赖。

Maven配置示例（pom.xml）：

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

Gradle配置示例（build.gradle）：

dependencies {
    implementation 'io.springfox:springfox-swagger2:2.9.2'
    implementation 'io.springfox:springfox-swagger-ui:2.9.2'
}

3. 配置Swagger

创建一个Swagger配置类来启用Swagger文档生成。以下是一个Spring Boot/Spring MVC的配置类示例：

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.any())
                .paths(PathSelectors.any())
                .build();
    }
}

4. 运行应用

启动你的Spring Boot或Spring MVC应用。Swagger会自动生成API文档。

5. 访问Swagger UI

在浏览器中访问 http://localhost:8080/swagger-ui.html（端口号根据实际情况调整），即可查看和测试API文档。

使用Docker容器部署Swagger Editor和Swagger UI

如果你希望更方便地部署和管理Swagger，可以使用Docker容器。

安装Docker：

sudo apt update
sudo apt install docker.io
sudo systemctl start docker
sudo systemctl enable docker

拉取并运行Swagger Editor和Swagger UI容器：

docker pull swaggerapi/swagger-editor:v4.6.0
docker run -d -p 38080:8080 swaggerapi/swagger-editor:v4.6.0

docker pull swaggerapi/swagger-ui:v4.15.5
docker run -d -p 38081:8080 swaggerapi/swagger-ui:v4.15.5

访问Swagger Editor和Swagger UI：

• Swagger Editor: http://your_server_ip:38080
• Swagger UI: http://your_server_ip:38081

通过以上步骤，你可以在Linux系统上成功集成Swagger，从而方便地进行API文档的生成和测试。