Package org.springframework.boot.autoconfigure.condition

Annotation Interface ConditionalOnBean

@Target({TYPE,METHOD}) @Retention(RUNTIME) @Documented @Conditional(org.springframework.boot.autoconfigure.condition.OnBeanCondition.class) public @interface ConditionalOnBean
@Conditional that only matches when beans meeting all the specified requirements are already contained in the BeanFactory. All the requirements must be met for the condition to match, but they do not have to be met by the same bean.

When placed on a @Bean method and none of value(), type(), name(), or annotation() has been specified, the bean type to match defaults to the return type of the @Bean method: 

 @Configuration
 public class MyAutoConfiguration {

     @ConditionalOnBean
     @Bean
     public MyService myService() {
         ...
     }

 }

In the sample above the condition will match if a bean of type MyService is already contained in the BeanFactory.

The condition can only match the bean definitions that have been processed by the application context so far and, as such, it is strongly recommended to use this condition on auto-configuration classes only. If a candidate bean may be created by another auto-configuration, make sure that the one using this condition runs after.

Since:
1.0.0
Author:
Phillip Webb

  • Optional Element Summary

    Optional Elements
    Modifier and Type
    Optional Element
    Description
    Class<? extends Annotation>[]
    annotation
    The annotation type decorating a bean that should be checked.
    String[]
    name
    The names of beans to check.
    Class<?>[]
    parameterizedContainer
    Additional classes that may contain the specified bean types within their generic parameters.
    SearchStrategy
    search
    Strategy to decide if the application context hierarchy (parent contexts) should be considered.
    String[]
    type
    The class type names of beans that should be checked.
    Class<?>[]
    value
    The class types of beans that should be checked.