概述

在当今的软件开发领域，API文档的维护变得越来越重要。Swagger是一个强大的API文档工具，它可以帮助开发者快速创建和更新API文档。Spring Boot作为一款流行的Java框架，与Swagger的集成可以让开发者更轻松地管理和维护API文档。本文将详细介绍如何在CentOS上集成Swagger与Spring Boot。

添加依赖

先说说在Spring Boot项目的pom.xml文件中添加Swagger和Swagger UI的依赖。

    
        io.springfox
        springfox-swagger2
        2.9.2
    
    
        io.springfox
        springfox-swagger-ui
        2.9.2
    

配置Swagger

接下来在Spring Boot项目中配置Swagger。创建一个名为SwaggerConfig的类，并使用@Configuration注解将其标记为配置类。在这个类中，你需要创建一个Docket对象，并配置它的属性。

package com.example.config;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
@Configuration
public class SwaggerConfig {
    @Bean
    public Docket api {
        return new Docket
                .select
                .apis)
                .paths)
                .build
                .apiInfo);
    }
    private ApiInfo apiInfo {
        return new ApiInfoBuilder
                .title
                .description
                .version
                .build;
    }
}

访问Swagger UI

启动你的Spring Boot应用程序后你可以通过浏览器访问Swagger UI界面。默认情况下URL应该是 http://:/swagger-ui.html。在这里你可以看到你的API文档，包括所有API端点和参数。

自定义Swagger UI

如果你想要自定义Swagger UI的外观或者行为， 你可以修改SwaggerConfig类中的配置，或者添加额外的配置参数。比方说你可以使用Docket的enable方法禁用Swagger UI界面。

return new Docket
                .select
                .apis)
                .paths)
                .build
                .apiInfo)
                .enable;

通过以上步骤，你可以在CentOS上成功地将Swagger与Spring Boot集成。Swagger可以帮助你快速创建和更新API文档，从而提高开发效率和API质量。希望本文对你有所帮助。

---