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的集成更加緊密。