ConditionalOnProperty配置swagger不生效問(wèn)題及解決

更新時(shí)間：2022年06月14日 08:39:42 作者：灰暗角落里的琴

這篇文章主要介紹了ConditionalOnProperty配置swagger不生效問(wèn)題及解決方案，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教

ConditionalOnProperty配置swagger不生效

問(wèn)題

在正式環(huán)境準(zhǔn)備關(guān)閉Swagger，添加了ConditionalOnProperty注解進(jìn)行配置，結(jié)果發(fā)現(xiàn)怎么也無(wú)法關(guān)閉swagger。

問(wèn)題原因

@EnableSwagger2在多個(gè)地方進(jìn)行了配置，如下：

1）應(yīng)用程序處進(jìn)行了配置

@SpringCloudApplication
@EnableSwagger2 ?//在應(yīng)用程序處進(jìn)行了配置
public class SysApplication {
?
? ? public static void main(String[] args) {
? ? ? ? SpringApplication.run(SysApplication.class,args);
? ? }
}

2）swagger處進(jìn)行了配置

@Configuration
@EnableSwagger2 ?//在swagger本身配置處進(jìn)行了配置
@ConditionalOnProperty(value = "swagger.manenabled", havingValue = "true")
public class SwaggerConfig {
}

實(shí)際在2）處的配置已經(jīng)生效，但由于1）處有配置所以造成這個(gè)問(wèn)題。

解決方案

將1）處的配置關(guān)閉即可。

@ConditionalOnProperty理解和使用

在Spring應(yīng)用程序開(kāi)發(fā)的過(guò)程中，可能需要根據(jù)配置屬性的存在和值有條件地創(chuàng)建一些bean，@ConditionalOnProperty注解用于僅在環(huán)境屬性存在且具有特定值時(shí)才啟用 bean 注冊(cè)。

注解源碼

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE, ElementType.METHOD})
@Documented
@Conditional({OnPropertyCondition.class})
public @interface ConditionalOnProperty {
//獲取對(duì)應(yīng)property名稱(chēng)的值，與name不可同時(shí)使用
    String[] value() default {};
 
//配置屬性名稱(chēng)的前綴
    String prefix() default "";
 
//配置屬性完整名稱(chēng)或部分名稱(chēng)
//可與prefix組合使用，組成完整的配置屬性名稱(chēng)，與value不可同時(shí)使用
    String[] name() default {};
 
//可與name組合使用，比較獲取到的屬性值與havingValue給定的值是否相同，相同才加載配置
    String havingValue() default "";
 
//缺少該配置屬性時(shí)是否可以加載。如果為true，沒(méi)有該配置屬性時(shí)也會(huì)正常加載；反之則不會(huì)生效
    boolean matchIfMissing() default false;
}

value以及 prefix + name 決定屬性值(Property Value)，以下為匹配規(guī)則

解析：假如havingValue為空，

屬性值為boolean類(lèi)型，則屬性值為true 加載該bean，屬性值為false 不加載該bean。
如果屬性值不為boolean類(lèi)型，則有該屬性則加載bean，沒(méi)有該屬性則不加載。

示例

屬性值不是boolean類(lèi)型的情況

@Bean(name = "emailNotification")
@ConditionalOnProperty(prefix = "notification", name = "service")
public NotificationSender notificationSender() {
    return new EmailNotification();
}

如果配置該屬性則加載：

notification.service=email

屬性值為boolean類(lèi)型

@Bean(name = "emailNotification")
@ConditionalOnProperty(prefix = "notification", name = "enable")
public NotificationSender notificationSender() {
    return new EmailNotification();
}

如果配置為true則加載