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