centos swagger自定義配置

在CentOS系統上自定義Swagger配置，通常涉及以下幾個步驟：

1. 安裝Swagger相關依賴

首先，確保你的CentOS系統已經安裝了必要的依賴包。你可以使用以下命令來安裝：

sudo yum install -y java-1.8.0-openjdk-devel maven

2. 添加Swagger依賴

在你的Spring Boot項目的pom.xml文件中添加Swagger依賴：

<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>

3. 配置Swagger

創建一個配置類來配置Swagger。例如，創建一個名為SwaggerConfig.java的文件：

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;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration
@EnableSwagger2
public class SwaggerConfig {

    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.yourpackage.controller")) // 替換為你的控制器包路徑
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("Your API Title")
                .description("Your API Description")
                .version("1.0.0")
                .build();
    }
}

4. 自定義Swagger UI

如果你想自定義Swagger UI的外觀和行為，可以在application.properties或application.yml文件中添加配置。例如：

application.properties

springfox.documentation.swagger.v2.path=/v2/api-docs
springfox.documentation.swagger-ui.base-url=/swagger-ui.html

application.yml

springfox:
  documentation:
    swagger:
      v2:
        path: /v2/api-docs
      swagger-ui:
        base-url: /swagger-ui.html

5. 啟動應用

啟動你的Spring Boot應用，然后訪問http://<your-server-address>:<port>/swagger-ui.html來查看Swagger UI界面。

6. 進一步自定義

如果你需要更高級的自定義，可以考慮以下幾點：

• 自定義Docket Bean：你可以創建多個Docket Bean來為不同的API組提供不同的配置。
• 自定義UI：你可以通過覆蓋Swagger UI的默認模板來實現更高級的自定義。
• 安全配置：如果你需要在生產環境中使用Swagger，確保配置適當的安全措施，例如使用Spring Security。

通過以上步驟，你應該能夠在CentOS系統上成功自定義Swagger配置。