org.springframework.boot.autoconfigure.condition

Annotation Type ConditionalOnMissingBean

@Target(value={TYPE,METHOD})
 @Retention(value=RUNTIME)
 @Documented
 @Conditional(value=org.springframework.boot.autoconfigure.condition.OnBeanCondition.class)
public @interface ConditionalOnMissingBean

Conditional that only matches when no beans meeting the specified requirements are already contained in the BeanFactory. None of the requirements must be met for the condition to match and the requirements do not have to be met by the same bean.

When placed on a @Bean method, the bean class defaults to the return type of the factory method:

 @Configuration
 public class MyAutoConfiguration {

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

 }

In the sample above the condition will match if no 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, Andy Wilkinson

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
Class<? extends Annotation>[]	annotation The annotation type decorating a bean that should be checked.
Class<?>[]	ignored The class types of beans that should be ignored when identifying matching beans.
String[]	ignoredType The class type names of beans that should be ignored when identifying matching beans.
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.

Element Detail

value

public abstract Class<?>[] value

The class types of beans that should be checked. The condition matches when no bean of each class specified is contained in the BeanFactory.

Returns:

the class types of beans to check

Default:

{}

type

public abstract String[] type

The class type names of beans that should be checked. The condition matches when no bean of each class specified is contained in the BeanFactory.

Returns:

the class type names of beans to check

Default:

{}

ignored

public abstract Class<?>[] ignored

The class types of beans that should be ignored when identifying matching beans.

Returns:

the class types of beans to ignore

Since:

1.2.5

Default:

{}

ignoredType

public abstract String[] ignoredType

The class type names of beans that should be ignored when identifying matching beans.

Returns:

the class type names of beans to ignore

Since:

1.2.5

Default:

{}

annotation

public abstract Class<? extends Annotation>[] annotation

The annotation type decorating a bean that should be checked. The condition matches when each annotation specified is missing from all beans in the BeanFactory.

Returns:

the class-level annotation types to check

Default:

{}

name

public abstract String[] name

The names of beans to check. The condition matches when each bean name specified is missing in the BeanFactory.

Returns:

the names of beans to check

Default:

{}

search

public abstract SearchStrategy search

Strategy to decide if the application context hierarchy (parent contexts) should be considered.

Returns:

the search strategy

Default:

org.springframework.boot.autoconfigure.condition.SearchStrategy.ALL

parameterizedContainer

public abstract Class<?>[] parameterizedContainer

Additional classes that may contain the specified bean types within their generic parameters. For example, an annotation declaring value=Name.class and parameterizedContainer=NameRegistration.class would detect both Name and NameRegistration<Name>.

Returns:

the container types

Since:

2.1.0

Default:

{}