久久久久久久av_日韩在线中文_看一级毛片视频_日本精品二区_成人深夜福利视频_武道仙尊动漫在线观看

Spring?Boot?條件注解詳情

Java編程 html5模板網
這篇文章主要介紹了Spring?Boot?條件注解詳情，SpringBoot條件注解@Conditional，可用于根據某個特定的條件來判斷是否需要創建某個特定的Bean，下文更多相關介紹，需要的小伙伴可以參考一

前言：

SpringBoot條件注解@Conditional，可用于根據某個特定的條件來判斷是否需要創建某個特定的Bean。SpringBoot自動配置功能里面就大量的使用了條件注解。接下來我們就對@Conditional的使用做一個簡單的介紹。

@Conditional注解需要和Condition接口搭配一起使用。通過對應Condition接口來告知是否滿足匹配條件。

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Conditional {

    /**
     * 所有用于匹配的Condition接口(實現該接口的類)，只有這些類都返回true才認為是滿足條件
     */
    Class<? extends Condition>[] value();
}

@Conditional注解可以添加在@Configuration、@Component、@Service等修飾的類上用于控制對應的Bean是否需要創建，或者添加在@Bean修飾的方法上用于控制方法對應的Bean是否需要創建。

@Conditional添加在@Configuration修飾的類上，用于控制該類和該類里面所有添加的@Bean方法對應的Bean是否需要創建。

一 @Conditional擴展注解

為了方便我們的使用Spring Boot對@Conditional條件注解做了一些擴展，提供了一些很實用的擴展性條件注解。

上面的擴展注解我們可以簡單的分為以下幾類：

  • Bean作為條件：@ConditionalOnBean、@ConditionalOnMissingBean、@ConditionalOnSingleCandidate。
  • 類作為條件：@ConditionalOnClass、@ConditionalOnMissingClass。
  • SpEL表達式作為條件：@ConditionalOnExpression。
  • JAVA版本作為條件: @ConditionalOnJava
  • 配置屬性作為條件：@ConditionalOnProperty。
  • 資源文件作為條件：@ConditionalOnResource。
  • 是否Web應用作為判斷條件：@ConditionalOnWebApplication、@ConditionalOnNotWebApplication。

1.1 Bean作為條件

1.1.1 @ConditionalOnBean

 @ConditionalOnBean對應的Condition處理類是OnBeanCondition。如果Spring容器里面存在指定的Bean則生效。

@ConditionalOnBean配置參數

@Target({ ElementType.TYPE, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Conditional(OnBeanCondition.class)
public @interface ConditionalOnBean {
    /**
     * 需要作為條件的類的Class對象數組
     */
    Class<?>[] value() default {};
    /**
     * 需要作為條件的類的Name, Class.getName()
     */
    String[] type() default {};

    /**
     * (用于指定注解修飾的Bean)條件所需的注解類
     */
    Class<? extends Annotation>[] annotation() default {};
    /**
     * Spring容器中Bean的名字
     */
    String[] name() default {};
    /**
     * 搜索容器層級，當前容器，父容器
     */
    SearchStrategy search() default SearchStrategy.ALL;

    /**
     * 可能在其泛型參數中包含指定Bean類型的其他類
     */
    Class<?>[] parameterizedContainer() default {};
}

1.1.2 @ConditionalOnMissingBean

@ConditionalOnMissingBean對應的Condition實現類是OnBeanCondition。如果Spring容器里面不存在指定的Bean則生效。

@ConditionalOnMissingBean配置參數

@Target({ ElementType.TYPE, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Conditional(OnBeanCondition.class)
public @interface ConditionalOnMissingBean {
    /**
     * 需要作為條件的類的Class對象數組
     */
    Class<?>[] value() default {};

    /**
     * 需要作為條件的類的Name, Class.getName()
     */
    String[] type() default {};

    /**
     * 匹配Bean的時候需要忽視的Class對象數組，一般是父類
     * @ConditionalOnMissingBean(value = JdbcFactory.class, ignored = MySqlDefaultFactory.class)
     */
    Class<?>[] ignored() default {};

    /**
     * 匹配Bean的時候需要忽視的類的Name, Class.getName()
     */
    String[] ignoredType() default {};
    /**
     * (用于指定注解修飾的Bean)條件所需的注解類
     */
    Class<? extends Annotation>[] annotation() default {};

    /**
     * Spring容器中Bean的名字
     */
    String[] name() default {};

    /**
     * 搜索容器層級，當前容器，父容器
     */
    SearchStrategy search() default SearchStrategy.ALL;

    /**
     * 可能在其泛型參數中包含指定Bean類型的其他類
     */
    Class<?>[] parameterizedContainer() default {};
}

比如如下的實例，當容器里面不存在redisTemplate對應的Bean的時候，就會創建一個RedisTemplate添加到容器里面去。

    @Bean
    @ConditionalOnMissingBean(name = "redisTemplate")
    public RedisTemplate<Object, Object> redisTemplate(RedisConnectionFactory redisConnectionFactory)
            throws UnknownHostException {
        RedisTemplate<Object, Object> template = new RedisTemplate<>();
        template.setConnectionFactory(redisConnectionFactory);
        return template;
    }

1.1.3 @ConditionalOnSingleCandidate

 @ConditionalOnSingleCandidate對應的Condition處理類是OnBeanCondition。如果當指定Bean在容器中只有一個，或者雖然有多個但是指定首選Bean的時候則生效。

@ConditionalOnSingleCandidate配置參數

@Target({ ElementType.TYPE, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Conditional(OnBeanCondition.class)
public @interface ConditionalOnSingleCandidate {
    /**
     * 需要作為條件的類的Class對象
     */
    Class<?> value() default Object.class;

    /**
     * 需要作為條件的類的Name, Class.getName()
     */
    String type() default "";

    /**
     * 搜索容器層級，當前容器，父容器
     */
    SearchStrategy search() default SearchStrategy.ALL;
}

1.2 類作為條件

1.2.1 @ConditionalOnClass

 @ConditionalOnClass對應的Condition處理類是OnClassCondition。如果當前類路徑下面有指定的類的時候則生效。

@ConditionalOnClass配置屬性介紹

@Target({ ElementType.TYPE, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Conditional(OnClassCondition.class)
public @interface ConditionalOnClass {
    /**
     * 需要作為條件的類的Class對象數組
     */
    Class<?>[] value() default {};
    /**
     * 需要作為條件的類的Name, Class.getName()
     */
    String[] name() default {};
}

1.2.2 @ConditionalOnMissingClass

 @ConditionalOnMissingClass對應的Condition處理類是OnClassCondition。如果當前類路徑下面沒有指定的類的時候則生效。

@Target({ ElementType.TYPE, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Conditional(OnClassCondition.class)
public @interface ConditionalOnMissingClass {
    /**
     * 需要作為條件的類的Name, Class.getName()
     */
    String[] value() default {};
}

1.3 SpEL表達式作為條件

@ConditionalOnExpression對應的Condition處理類是OnExpressionCondition。只有當SpEL表達式滿足條件的時候則生效。

@Retention(RetentionPolicy.RUNTIME)
@Target({ ElementType.TYPE, ElementType.METHOD })
@Documented
@Conditional(OnExpressionCondition.class)
public @interface ConditionalOnExpression {
    /**
     * 要作為條件的SpEL表達式
     */
    String value() default "true";
}

例如@ConditionalOnExpression("${test.enabled:true}")，只有當配置文件里面存在test.enabled: true的時候則生效。

更加詳細的用法可以去看下SpEL表達式的使用。

1.4 JAVA版本作為判斷條件

 @ConditionalOnJava對應的Condition處理類是OnJavaCondition。只有當指定的JAVA版本條件滿足的時候，才會創建對應的Bean。

@Target({ ElementType.TYPE, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Conditional(OnJavaCondition.class)
public @interface ConditionalOnJava {
    /**
     * 比較方式，Range.EQUAL_OR_NEWER:當前版本等于或高于、Range.OLDER_THAN:當前版本老于，越早的版本越老
     */
    Range range() default Range.EQUAL_OR_NEWER;

    /**
     * 指定JAVA版本
     */
    JavaVersion value();
    /**
     * Range options.
     */
    enum Range {
        /**
         * Equal to, or newer than the specified {@link JavaVersion}.
         */
        EQUAL_OR_NEWER,

        /**
         * Older than the specified {@link JavaVersion}.
         */
        OLDER_THAN
    }
}

1.5 配置屬性作為判斷條件

@ConditionalOnProperty對應的Condition實現類OnPropertyCondition。只有當對應的配置屬性和給定條件的值相等的時候則生效。

@Retention(RetentionPolicy.RUNTIME)
@Target({ ElementType.TYPE, ElementType.METHOD })
@Documented
@Conditional(OnPropertyCondition.class)
public @interface ConditionalOnProperty {
    /**
     * 對應property名稱的值
     */
    String[] value() default {};
    String[] name() default {};
    /**
     * property名稱的前綴，可有可無
     */
    String prefix() default "";

    /**
     * 與name組合使用，比較獲取到的屬性值與havingValue給定的值是否相同，相同才加載配置
     */
    String havingValue() default "";
    /**
     * 缺少該property時是否可以加載。如果為true，沒有該property也會正常加載；反之報錯
     */
    boolean matchIfMissing() default false;
}

 @ConditionalOnProperty(prefix = “spring.aop”, name = “auto”, havingValue = “true”)表示當配置文件里面spring.aop.auto=true的時候才會加載對應的Bean。

1.6 資源文件是否存在作為判斷條件

@ConditionalOnResource對應的Condition處理類OnResourceCondition。只有當指定的資源文件出現在classpath中則生效。

@ConditionalOnResource配置屬性

@Target({ ElementType.TYPE, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Conditional(OnResourceCondition.class)
public @interface ConditionalOnResource {
    /**
     * 要作為判斷條件的資源文件名稱  @ConditionalOnResource(resources=”mybatis.xml”)
     */
    String[] resources() default {};
}

1.7 是否Web應用作為判斷條件

1.7.1 @ConditionalOnWebApplication

@ConditionalOnWebApplication對應的Condition處理類是OnWebApplicationCondition。只有當當前項目是Web項目的時候則生效。

@Target({ ElementType.TYPE, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Conditional(OnWebApplicationCondition.class)
public @interface ConditionalOnWebApplication {
    /**
     * 需要作為條件的Web應用程序的必需類型
     */
    Type type() default Type.ANY;

    /**
     * Available application types.
     */
    enum Type {

        /**
         * 任何web應用都將匹配
         */
        ANY,

        /**
         * 僅基于servlet的Web應用程序將匹配
         */
        SERVLET,

        /**
         * 僅基于反應式的Web應用程序將匹配
         */
        REACTIVE
    }
}

1.7.2 @ConditionalOnNotWebApplication

@ConditionalOnNotWebApplication對應的Condition處理類是OnWebApplicationCondition。只有當當前項目不是Web項目的時候則生效。

@Target({ ElementType.TYPE, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Conditional(OnWebApplicationCondition.class)
public @interface ConditionalOnNotWebApplication {
}

二 @Conditional自定義

上面介紹每個擴展注解的時候都特意提到了每個注解對應的Condition實現類。其實我們可以仿照這些Condition實現類來實現我們自己的@Conditional注解。下面我們同個兩個簡單的實例來看下怎么實現自己的@Conditional擴展注解。

2.1 判斷是否配置指定屬性

 注意：和@ConditionalOnProperty不一樣哦，@ConditionalOnProperty是判斷是否有屬性并且判斷值是否等于我們指定的值。我們要實現的注解只判斷有沒有配置屬性，不管屬性對應的值。

擴展注解ConditionalOnPropertyExist。指定我們的Condition實現類OnPropertyExistCondition。并且指定兩個參數。一個是參數name用于指定屬性。另一個參數exist用于指定是判斷存在還是不存在。

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE, ElementType.METHOD})
@Documented
@Conditional(OnPropertyExistCondition.class)
public @interface ConditionalOnPropertyExist {

    /**
     * 配置文件里面對應的key
     */
    String name() default "";

    /**
     * 是否有配置的時候判斷通過
     */
    boolean exist() default true;

}

OnPropertyExistCondition類就是簡單的判斷下屬性存在與否。

public class OnPropertyExistCondition implements Condition {
    @Override
    public boolean matches(ConditionContext conditionContext, AnnotatedTypeMetadata annotatedTypeMetadata) {
        Map<String, Object> annotationAttributes = annotatedTypeMetadata.getAnnotationAttributes(ConditionalOnPropertyExist.class.getName());
        if (annotationAttributes == null) {
            return false;
        }
        String propertyName = (String) annotationAttributes.get("name");
        boolean values = (boolean) annotationAttributes.get("exist");
        String propertyValue = conditionContext.getEnvironment().getProperty(propertyName);
        if(values) {
            return !StringUtils.isEmpty(propertyValue);
        } else {
            return StringUtils.isEmpty(propertyValue);
        }
    }
}

2.1 判斷是否配置指定屬性

我們簡單實現這樣一個功能，根據指定的系統加載不同的Bean。

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE, ElementType.METHOD})
@Documented
@Conditional(OnSystemCondition.class)
public @interface ConditionalOnSystem {
    /**
     * 指定系統
     */
    SystemType type() default SystemType.WINDOWS;

    /**
     * 系統類型
     */
    enum SystemType {

        /**
         * windows系統
         */
        WINDOWS,

        /**
         * linux系統
         */
        LINUX,

        /**
         * mac系統
         */
        MAC

    }
}
public class OnSystemCondition implements Condition {
    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        Map<String, Object> annotationAttributes = metadata.getAnnotationAttributes(ConditionalOnSystem.class.getName());
        if (annotationAttributes == null) {
            return false;
        }
        ConditionalOnSystem.SystemType systemType = (ConditionalOnSystem.SystemType) annotationAttributes.get("type");
        switch (systemType) {
            case WINDOWS:
                return context.getEnvironment().getProperty("os.name").contains("Windows");
            case LINUX:
                return context.getEnvironment().getProperty("os.name").contains("Linux ");
            case MAC:
                return context.getEnvironment().getProperty("os.name").contains("Mac ");
        }
        return false;
    }
}

到此這篇關于Spring Boot 條件注解詳情的文章就介紹到這了,更多相關Spring Boot內容請搜索html5模板網以前的文章希望大家以后多多支持html5模板網！

【網站聲明】本站部分內容來源于互聯網,旨在幫助大家更快的解決問題，如果有圖片或者內容侵犯了您的權益，請聯系我們刪除處理，感謝您的支持！

相關文檔推薦

這篇文章主要為大家詳細介紹了如何利用SpringBoot+WebSocket實現即時通訊功能，文中示例代碼講解詳細，對我們學習或工作有一定參考價值，需要的可以參考一下
本文主要介紹了SpringBoot二維碼生成base64并上傳OSS的實現示例，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學
本文主要介紹了SpringSecurity實現退出登錄和退出處理器，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習
這篇文章主要介紹了Spring?boot?整合?Redisson實現分布式鎖并驗證,redisson是官方推薦的分布式鎖實現方案，采用redis自身的原子命令和lua腳本來實現，需要的朋友可以參考下
這篇文章主要介紹了springboot+redis實現一個簡單的熱搜功能,通過代碼介紹了過濾不雅文字的過濾器，代碼簡單易懂，對大家的學習或工作具有一定的參考借鑒價值，需要的朋友可以參考下
這篇文章主要介紹了在SpringBoot中使用HATEOAS的方法，HATEOAS是實現REST規范的一種原則，通過遵循HATEOAS規范，可以解決我們實際代碼實現的各種個問題，下文更多相關介紹，需要的小伙伴可
主站蜘蛛池模板： 欧美在线一区二区三区 | 亚洲一区二区视频 | 中文字幕av高清 | 青青草一区二区 | 国产欧美在线一区二区 | 国产精品亚洲片在线播放 | 欧美精品a∨在线观看不卡 欧美日韩中文字幕在线播放 | 亚洲视频在线一区 | 亚洲国产激情 | 日本一区二区三区精品视频 | 精品国产欧美日韩不卡在线观看 | 中文字幕乱码一区二区三区 | 一级做a爰片久久毛片免费看 | 97久久精品 | 亚洲欧美网站 | 国产精品久久久久久久久久久久午夜片 | 国产女人与拘做受免费视频 | 久久精品91久久久久久再现 | 国产精品久久亚洲 | 天天看天天操 | 欧美日韩一 | 日韩欧美国产精品一区 | 台湾a级理论片在线观看 | 91精品国产综合久久婷婷香蕉 | 中文字幕亚洲视频 | 最新中文字幕在线 | 成年人在线观看视频 | av黄色在线 | 欧美成人精品一区二区三区 | 日本成人在线观看网站 | 中文字幕国产视频 | 国产精品不卡一区 | www.日本三级 | 中文字幕二区 | 亚洲一一在线 | 亚洲一区二区三区四区视频 | www.五月天婷婷.com | 欧美激情黄色 | 国产精品资源在线 | 盗摄精品av一区二区三区 | 97视频免费 |