Annotation Interface EnableAutoConfiguration
tomcat-embedded.jar
on your classpath you are likely to want a
TomcatServletWebServerFactory
(unless you have defined your own
ServletWebServerFactory
bean).
When using @SpringBootApplication
, the auto-configuration
of the context is automatically enabled and adding this annotation has therefore no
additional effect.
Auto-configuration tries to be as intelligent as possible and will back-away as you
define more of your own configuration. You can always manually exclude()
any
configuration that you never want to apply (use excludeName()
if you don't
have access to them). You can also exclude them via the
spring.autoconfigure.exclude
property. Auto-configuration is always applied
after user-defined beans have been registered.
The package of the class that is annotated with @EnableAutoConfiguration
,
usually via @SpringBootApplication
, has specific significance and is often used
as a 'default'. For example, it will be used when scanning for @Entity
classes.
It is generally recommended that you place @EnableAutoConfiguration
(if you're
not using @SpringBootApplication
) in a root package so that all sub-packages
and classes can be searched.
Auto-configuration classes are regular Spring @Configuration
beans. They are located using ImportCandidates
and the
SpringFactoriesLoader
mechanism (keyed against this class). Generally
auto-configuration beans are @Conditional
beans (most often using
@ConditionalOnClass
and
@ConditionalOnMissingBean
annotations).
- Since:
- 1.0.0
- Author:
- Phillip Webb, Stephane Nicoll
- See Also:
-
Optional Element Summary
-
Field Summary
Modifier and TypeFieldDescriptionstatic final String
Environment property that can be used to override when auto-configuration is enabled.
-
Field Details
-
ENABLED_OVERRIDE_PROPERTY
Environment property that can be used to override when auto-configuration is enabled.- See Also:
-
-
Element Details
-
exclude
Class<?>[] excludeExclude specific auto-configuration classes such that they will never be applied.- Returns:
- the classes to exclude
- Default:
- {}
-
excludeName
String[] excludeNameExclude specific auto-configuration class names such that they will never be applied.- Returns:
- the class names to exclude
- Since:
- 1.3.0
- Default:
- {}
-