centos swagger项目搭建

在CentOS上搭建Swagger项目，通常指的是使用Springfox库来集成Swagger到你的Spring Boot应用中。以下是搭建Swagger项目的步骤：

1. 创建Spring Boot项目： 你可以使用Spring Initializr（https://start.spring.io/）来生成一个Spring Boot项目的基础结构。选择必要的依赖项，如Spring Web。

2. 添加Swagger依赖： 在你的pom.xml文件中添加Springfox Swagger2和Swagger UI的依赖项。

   <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的版本可能会更新，所以请检查最新的版本。

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")) // 替换为你的controller包路径
                   .paths(PathSelectors.any())
                   .build();
       }
   }
   

4. 访问Swagger UI： 启动你的Spring Boot应用后，你可以通过浏览器访问Swagger UI界面。默认情况下，URL是http://localhost:8080/swagger-ui.html。

5. 编写API文档： 在你的Controller类和方法上添加Swagger注解，以便生成更详细的API文档。

   import springfox.documentation.annotations.Api;
   import springfox.documentation.annotations.ApiOperation;
   
   @RestController
   @RequestMapping("/api")
   @Api(tags = "示例接口")
   public class ExampleController {
   
       @ApiOperation("获取示例数据")
       @GetMapping("/data")
       public String getData() {
           return "Hello, Swagger!";
       }
   }
   

6. 运行和测试： 运行你的Spring Boot应用，并访问Swagger UI来查看和测试你的API文档。

请注意，随着Springfox的发展，可能会有一些变化，特别是在Spring Boot 2.6及以上版本中，Springfox可能不完全兼容。如果你遇到任何问题，可以考虑查看Springfox的官方文档或者在社区寻求帮助。此外，还有其他工具如SpringDoc OpenAPI，它是Springfox的一个替代品，提供了对OpenAPI 3的支持，并且与Spring Boot的集成更加紧密。