仅当 BeanFactory 中不包含指定的 bean class 和/或 name 时条件匹配
该条件只能匹配到目前为止 application context 已经处理的 bean 定义,因此强烈建议仅在自动配置类上使用此条件。
如果候选 bean 可能由另一个自动配置创建,请确保使用此 condition 的自动配置类在其后运行。
@Target({ ElementType.TYPE, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Conditional(OnBeanCondition.class)
public @interface ConditionalOnMissingBean {
/**
* 需要检查的 bean 的 class 类型。当 ApplicationContext 不包含每一个被指定的 class 时条件匹配。
*/
Class<?>[] value() default {};
/**
* 需要检查的 bean 的 class 类型名称(Java全限定名)。当 ApplicationContext 不包含每一个被指定的 class 时条件匹配。
*/
String[] type() default {};
/**
* 识别匹配 bean 时,可以被忽略的 bean 的 class 类型
*/
Class<?>[] ignored() default {};
/**
* 识别匹配 bean 时,可以被忽略的 bean 的 class 类型名称(Java全限定名)
*/
String[] ignoredType() default {};
/**
* 装饰需要检查的 bean 的注解。当 ApplicationContext 不包含带有这些注解的 bean 时条件匹配。
*/
Class<? extends Annotation>[] annotation() default {};
/**
* 需要检查的 bean 的 name。当 ApplicationContext 不包含任意指定的每一个的 class 时条件匹配。
*/
String[] name() default {};
/**
* 决定是否应考虑 application context 层次(parent contexts)的策略。
*/
SearchStrategy search() default SearchStrategy.ALL;
}
使用示例如下:
@ConditionalOnMissingBean
@ConditionalOnMissingBean(TransactionManager.class)
@ConditionalOnMissingBean(ignored = {DistributedCommandBus.class})
@ConditionalOnMissingBean({EventStorageEngine.class, EventBus.class, EventStore.class})
网友评论