org.springframework.boot.test.context

Class SpringBootTestContextBootstrapper

java.lang.Object

org.springframework.test.context.support.AbstractTestContextBootstrapper

org.springframework.test.context.support.DefaultTestContextBootstrapper

org.springframework.boot.test.context.SpringBootTestContextBootstrapper

All Implemented Interfaces:

TestContextBootstrapper

public class SpringBootTestContextBootstrapper
extends DefaultTestContextBootstrapper

TestContextBootstrapper for Spring Boot. Provides support for @SpringBootTest and may also be used directly or subclassed. Provides the following features over and above DefaultTestContextBootstrapper:

• Uses SpringBootContextLoader as the default context loader.
• Automatically searches for a @SpringBootConfiguration when required.
• Allows custom Environment getProperties(Class) to be defined.
• Provides support for different webEnvironment modes.

Since:

1.4.0

Author:

Phillip Webb, Andy Wilkinson

See Also:

SpringBootTest, TestConfiguration

Constructor Summary

Constructors

Constructor and Description
SpringBootTestContextBootstrapper()

Method Summary

Modifier and Type	Method and Description
TestContext	buildTestContext()
protected MergedContextConfiguration	createModifiedConfig(MergedContextConfiguration mergedConfig, Class<?>[] classes) Create a new MergedContextConfiguration with different classes.
protected MergedContextConfiguration	createModifiedConfig(MergedContextConfiguration mergedConfig, Class<?>[] classes, String[] propertySourceProperties) Create a new MergedContextConfiguration with different classes and properties.
protected SpringBootTest	getAnnotation(Class<?> testClass)
protected Class<?>[]	getClasses(Class<?> testClass)
protected Class<? extends ContextLoader>	getDefaultContextLoaderClass(Class<?> testClass)
protected Set<Class<? extends TestExecutionListener>>	getDefaultTestExecutionListenerClasses()
protected String	getDifferentiatorPropertySourceProperty() Return a "differentiator" property to ensure that there is something to differentiate regular tests and bootstrapped tests.
protected Class<?>[]	getOrFindConfigurationClasses(MergedContextConfiguration mergedConfig)
protected String[]	getProperties(Class<?> testClass)
protected SpringBootTest.WebEnvironment	getWebEnvironment(Class<?> testClass) Return the SpringBootTest.WebEnvironment type for this test or null if undefined.
protected MergedContextConfiguration	processMergedContextConfiguration(MergedContextConfiguration mergedConfig)
protected void	processPropertySourceProperties(MergedContextConfiguration mergedConfig, List<String> propertySourceProperties) Post process the property source properties, adding or removing elements as required.
protected ContextLoader	resolveContextLoader(Class<?> testClass, List<ContextConfigurationAttributes> configAttributesList)
protected void	verifyConfiguration(Class<?> testClass)

Methods inherited from class org.springframework.test.context.support.AbstractTestContextBootstrapper

buildMergedContextConfiguration, getBootstrapContext, getCacheAwareContextLoaderDelegate, getContextCustomizerFactories, getDefaultTestExecutionListenerClassNames, getTestExecutionListeners, resolveExplicitContextLoaderClass, setBootstrapContext

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SpringBootTestContextBootstrapper

public SpringBootTestContextBootstrapper()

Method Detail

buildTestContext

public TestContext buildTestContext()

Specified by:

buildTestContext in interface TestContextBootstrapper

Overrides:

buildTestContext in class AbstractTestContextBootstrapper

getDefaultTestExecutionListenerClasses

protected Set<Class<? extends TestExecutionListener>> getDefaultTestExecutionListenerClasses()

Overrides:

getDefaultTestExecutionListenerClasses in class AbstractTestContextBootstrapper

resolveContextLoader

protected ContextLoader resolveContextLoader(Class<?> testClass,
                                             List<ContextConfigurationAttributes> configAttributesList)

Overrides:

resolveContextLoader in class AbstractTestContextBootstrapper

getDefaultContextLoaderClass

protected Class<? extends ContextLoader> getDefaultContextLoaderClass(Class<?> testClass)

Overrides:

getDefaultContextLoaderClass in class DefaultTestContextBootstrapper

processMergedContextConfiguration

protected MergedContextConfiguration processMergedContextConfiguration(MergedContextConfiguration mergedConfig)

Overrides:

processMergedContextConfiguration in class AbstractTestContextBootstrapper

getOrFindConfigurationClasses

protected Class<?>[] getOrFindConfigurationClasses(MergedContextConfiguration mergedConfig)

getDifferentiatorPropertySourceProperty

protected String getDifferentiatorPropertySourceProperty()

Return a "differentiator" property to ensure that there is something to differentiate regular tests and bootstrapped tests. Without this property a cached context could be returned that wasn't created by this bootstrapper. By default uses the bootstrapper class as a property.

Returns:

the differentiator or null

processPropertySourceProperties

protected void processPropertySourceProperties(MergedContextConfiguration mergedConfig,
                                               List<String> propertySourceProperties)

Post process the property source properties, adding or removing elements as required.

Parameters:

mergedConfig - the merged context configuration

propertySourceProperties - the property source properties to process

getWebEnvironment

protected SpringBootTest.WebEnvironment getWebEnvironment(Class<?> testClass)

Return the SpringBootTest.WebEnvironment type for this test or null if undefined.

Parameters:

testClass - the source test class

Returns:

the SpringBootTest.WebEnvironment or null

getClasses

protected Class<?>[] getClasses(Class<?> testClass)

getProperties

protected String[] getProperties(Class<?> testClass)

getAnnotation

protected SpringBootTest getAnnotation(Class<?> testClass)

verifyConfiguration

protected void verifyConfiguration(Class<?> testClass)

createModifiedConfig

protected final MergedContextConfiguration createModifiedConfig(MergedContextConfiguration mergedConfig,
                                                                Class<?>[] classes)

Create a new MergedContextConfiguration with different classes.

Parameters:

mergedConfig - the source config

classes - the replacement classes

Returns:

a new MergedContextConfiguration

createModifiedConfig

protected final MergedContextConfiguration createModifiedConfig(MergedContextConfiguration mergedConfig,
                                                                Class<?>[] classes,
                                                                String[] propertySourceProperties)

Create a new MergedContextConfiguration with different classes and properties.

Parameters:

mergedConfig - the source config

classes - the replacement classes

propertySourceProperties - the replacement properties

Returns:

a new MergedContextConfiguration