Annotation Type SpringBootTest
@Target(TYPE) @Retention(RUNTIME) @Documented @Inherited @BootstrapWith(SpringBootTestContextBootstrapper.class) @ExtendWith(org.springframework.test.context.junit.jupiter.SpringExtension.class) public @interface SpringBootTest
Annotation that can be specified on a test class that runs Spring Boot based tests. Provides the following features over and above the regular Spring TestContext Framework:- Uses
SpringBootContextLoaderas the defaultContextLoaderwhen no specific@ContextConfiguration(loader=...)is defined. - Automatically searches for a
@SpringBootConfigurationwhen nested@Configurationis not used, and no explicitclassesare specified. - Allows custom
Environmentproperties to be defined using theproperties attribute. - Provides support for different
webEnvironmentmodes, including the ability to start a fully running web server listening on adefinedorrandomport. - Registers a
TestRestTemplateand/orWebTestClientbean for use in web tests that are using a fully running web server.
- Since:
- 1.4.0
- See Also:
ContextConfiguration
- Uses
Optional Element Summary
Optional Elements Modifier and Type Optional Element Description Class<?>[]classesThe annotated classes to use for loading anApplicationContext.String[]propertiesProperties in form key=value that should be added to the SpringEnvironmentbefore the test runs.String[]valueAlias forproperties().SpringBootTest.WebEnvironmentwebEnvironmentThe type of web environment to create when applicable.
Element Detail
value
@AliasFor("properties") String[] valueAlias forproperties().- Returns:
- the properties to apply
- Default:
- {}
properties
@AliasFor("value") String[] propertiesProperties in form key=value that should be added to the SpringEnvironmentbefore the test runs.- Returns:
- the properties to add
- Default:
- {}
classes
Class<?>[] classes
The annotated classes to use for loading anApplicationContext. Can also be specified using@ContextConfiguration(classes=...). If no explicit classes are defined the test will look for nested@Configurationclasses, before falling back to aSpringBootConfigurationsearch.- Returns:
- the annotated classes used to load the application context
- See Also:
ContextConfiguration.classes()
- Default:
- {}
webEnvironment
SpringBootTest.WebEnvironment webEnvironment
The type of web environment to create when applicable. Defaults toSpringBootTest.WebEnvironment.MOCK.- Returns:
- the type of web environment
- Default:
- org.springframework.boot.test.context.SpringBootTest.WebEnvironment.MOCK