Spring Boot 禁用 Swagger 的三种方式

阅读目录(Content)本文来讨论在 Spring Boot 中禁用swagger一、方法一：使用@Profile二、方法二：使用 @Value() 推荐使用三、方法三：使用@ConditionalOnProperty回到顶部(go to top)本文来讨论在 Spring Boot 中禁用swagger原文：https://blog.csdn.net/weixin_37264997/artic

kjf00

13100人浏览 · 2021-04-12 10:06:01

kjf00 · 2021-04-12 10:06:01 发布

阅读目录(Content)

本文来讨论在 Spring Boot 中禁用swagger
- 一、方法一：使用@Profile 推荐使用
- 二、方法二：使用 @Value() 对于多模块项目，需各自添加属性
- 三、方法三：使用@ConditionalOnProperty

回到顶部(go to top)

本文来讨论在 Spring Boot 中禁用swagger

原文：https://blog.csdn.net/weixin_37264997/article/details/82762050

一、方法一：使用`@Profile`

使用注解@Profile({“dev”,“test”})表示在开发或测试环境开启，而在生产关闭。（推荐使用）


@Configuration
@EnableSwagger2
@Profile({"local", "dev"})
public class Swagger2Config {
    @Bean
    public Docket swaggerPersonApi10() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.unidata.cloud.logservice.api.controller"))
                .paths(PathSelectors.any())
                .build()
                .apiInfo(apiInfo());
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .version("1.0")
                .title("xx项目：xx平台 Swagger2 文档 API")
                .contact(new Contact("  xx团队", "https://www.xx.com/", "kangjia@xx.com"))
                .description("logservice platform API v1.0")
                .build();
    }
}

二、方法二：使用 @Value() 推荐使用

在Swagger2Config类里添加


@Configuration
@EnableSwagger2
public class Swagger2Config {
    
    @Value("${swagger.enable}")
    private Boolean enable;
    
    @Bean
    public Docket swaggerPersonApi10() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.unidata.cloud.logservice.api.controller"))
                .paths(PathSelectors.any())
            	.enable(enable)    //配置在该处生效
                .build()
                .apiInfo(apiInfo());
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .version("1.0")
                .title("xx项目：xx平台 Swagger2 文档 API")
                .contact(new Contact("  xx团队", "https://www.xx.com/", "kangjia@xx.com"))
                .description("logservice platform API v1.0")
                .build();
    }
}

在配置文件里添加一个swagger.enable属性，根据不同的application-xx.yml进行动态插入true或false即可。

三、方法三：使用`@ConditionalOnProperty`

使用注解@ConditionalOnProperty(name = “swagger.enable”, havingValue = “true”)


@Configuration
@EnableSwagger2
//@ConditionalOnProperty(name ="enabled" ,prefix = "swagger",havingValue = "true",matchIfMissing = true   //matchIfMissing=true :为空则设为true,不合理
@ConditionalOnProperty(name = “swagger.enable”, havingValue = “true”)
public class Swagger2Config {
    
    @Bean
    public Docket swaggerPersonApi10() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.unidata.cloud.logservice.api.controller"))
                .paths(PathSelectors.any())
            	.enable(enable)
                .build()
                .apiInfo(apiInfo());
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .version("1.0")
                .title("xx项目：xx平台 Swagger2 文档 API")
                .contact(new Contact("  xx团队", "https://www.xxx.com/", "kangjia@xxx.com"))
                .description("logservice platform API v1.0")
                .build();
    }
}