Ubuntu Swagger如何管理依赖

在Ubuntu系统中，Swagger的依赖管理通常是通过Maven或Gradle这样的构建工具来实现的。以下是使用Maven管理Swagger依赖的步骤：

1. 安装Java开发环境： 确保你的Ubuntu系统上已经安装了Java开发环境。可以使用以下命令来安装OpenJDK：

   sudo apt-get update
   sudo apt-get install openjdk-11-jdk
   java -version
   

2. 安装Maven： 使用以下命令下载并安装Maven：

   sudo apt-get install maven
   mvn -version
   

3. 创建Spring Boot项目： 使用Spring Initializr创建一个新的Spring Boot项目，并选择必要的依赖，例如spring-boot-starter-web。

4. 添加Swagger依赖： 在项目的pom.xml文件中添加Swagger相关的依赖。以下是Springfox库的示例依赖：

   <dependencies>
       <!-- Swagger2 -->
       <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>
       <!-- Springfox Swagger UI -->
       <dependency>
           <groupId>io.springfox</groupId>
           <artifactId>springfox-swagger-ui</artifactId>
           <version>2.9.2</version>
       </dependency>
       <!-- 其他依赖 -->
       <dependency>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-test</artifactId>
           <scope>test</scope>
       </dependency>
   </dependencies>
   

5. 配置Swagger： 创建一个名为SwaggerConfig.java的配置类，用于配置Swagger：

   package com.example.demo.config;
   
   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();
       }
   }
   

6. 构建和运行项目： 使用Maven构建项目：

   mvn clean install
   

   运行Spring Boot应用程序：

   java -jar target/demo-0.0.1-SNAPSHOT.jar
   

7. 访问Swagger UI： 启动应用程序后，可以通过浏览器访问Swagger UI界面，默认地址为：

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

通过以上步骤，你可以在Ubuntu系统上成功管理Swagger的依赖，并配置Swagger以生成API文档。如果需要使用Swagger 3（OpenAPI 3），可以考虑使用springdoc-openapi库，它是springfox的替代品，并且对Spring Boot 3有更好的支持。