org.springframework.test.context.support

Class AbstractContextLoader

java.lang.Object

org.springframework.test.context.support.AbstractContextLoader

All Implemented Interfaces:

ContextLoader, SmartContextLoader

Direct Known Subclasses:

AbstractGenericContextLoader, AbstractGenericWebContextLoader

public abstract class AbstractContextLoader
extends java.lang.Object
implements SmartContextLoader

Abstract application context loader that provides a basis for all concrete implementations of the ContextLoader SPI. Provides a Template Method based approach for processing resource locations.

As of Spring 3.1, AbstractContextLoader also provides a basis for all concrete implementations of the SmartContextLoader SPI. For backwards compatibility with the ContextLoader SPI, processContextConfiguration(ContextConfigurationAttributes) delegates to processLocations(Class, String...).

Since:

2.5

Author:

Sam Brannen, Juergen Hoeller, Phillip Webb

See Also:

generateDefaultLocations(java.lang.Class<?>), getResourceSuffixes(), modifyLocations(java.lang.Class<?>, java.lang.String...), prepareContext(org.springframework.context.ConfigurableApplicationContext, org.springframework.test.context.MergedContextConfiguration), customizeContext(org.springframework.context.ConfigurableApplicationContext, org.springframework.test.context.MergedContextConfiguration)

Constructor Summary

Constructors

Constructor and Description
AbstractContextLoader()

Method Summary

Modifier and Type	Method and Description
protected void	customizeContext(ConfigurableApplicationContext context, MergedContextConfiguration mergedConfig) Customize the ConfigurableApplicationContext created by this ContextLoader after bean definitions have been loaded into the context but before the context has been refreshed.
protected java.lang.String[]	generateDefaultLocations(java.lang.Class<?> clazz) Generate the default classpath resource locations array based on the supplied class.
protected abstract java.lang.String	getResourceSuffix() Get the suffix to append to ApplicationContext resource locations when detecting default locations.
protected java.lang.String[]	getResourceSuffixes() Get the suffixes to append to ApplicationContext resource locations when detecting default locations.
protected boolean	isGenerateDefaultLocations() Determine whether or not default resource locations should be generated if the locations provided to processLocations(Class, String...) are null or empty.
protected java.lang.String[]	modifyLocations(java.lang.Class<?> clazz, java.lang.String... locations) Generate a modified version of the supplied locations array and return it.
protected void	prepareContext(ConfigurableApplicationContext context, MergedContextConfiguration mergedConfig) Prepare the ConfigurableApplicationContext created by this SmartContextLoader before bean definitions are read.
void	processContextConfiguration(ContextConfigurationAttributes configAttributes) For backwards compatibility with the ContextLoader SPI, the default implementation simply delegates to processLocations(Class, String...), passing it the declaring class and resource locations retrieved from the supplied configuration attributes.
java.lang.String[]	processLocations(java.lang.Class<?> clazz, java.lang.String... locations) If the supplied locations are null or empty and isGenerateDefaultLocations() returns true, default locations will be generated (i.e., detected) for the specified class and the configured resource suffixes; otherwise, the supplied locations will be modified if necessary and returned.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.test.context.SmartContextLoader

loadContext

Methods inherited from interface org.springframework.test.context.ContextLoader

loadContext

Constructor Detail

AbstractContextLoader

public AbstractContextLoader()

Method Detail

processContextConfiguration

public void processContextConfiguration(ContextConfigurationAttributes configAttributes)

For backwards compatibility with the ContextLoader SPI, the default implementation simply delegates to processLocations(Class, String...), passing it the declaring class and resource locations retrieved from the supplied configuration attributes. The processed locations are then set in the supplied configuration attributes.

Can be overridden in subclasses — for example, to process annotated classes instead of resource locations.

Specified by:

processContextConfiguration in interface SmartContextLoader

Parameters:

configAttributes - the context configuration attributes to process

Since:

3.1

See Also:

processLocations(Class, String...)

prepareContext

protected void prepareContext(ConfigurableApplicationContext context,
                              MergedContextConfiguration mergedConfig)

Prepare the ConfigurableApplicationContext created by this SmartContextLoader before bean definitions are read.

The default implementation:

• Sets the active bean definition profiles from the supplied MergedContextConfiguration in the Environment of the context.
• Adds PropertySources for all resource locations and inlined properties from the supplied MergedContextConfiguration to the Environment of the context.
• Determines what (if any) context initializer classes have been supplied via the MergedContextConfiguration and instantiates and invokes each with the given application context.
  • Any ApplicationContextInitializers implementing Ordered or annotated with @Order will be sorted appropriately.

Parameters:

context - the newly created application context

mergedConfig - the merged context configuration

Since:

3.2

See Also:

TestPropertySourceUtils.addPropertiesFilesToEnvironment(org.springframework.context.ConfigurableApplicationContext, java.lang.String...), TestPropertySourceUtils.addInlinedPropertiesToEnvironment(org.springframework.context.ConfigurableApplicationContext, java.lang.String...), ApplicationContextInitializer.initialize(ConfigurableApplicationContext), SmartContextLoader.loadContext(MergedContextConfiguration), ConfigurableApplicationContext.setId(java.lang.String)

customizeContext

protected void customizeContext(ConfigurableApplicationContext context,
                                MergedContextConfiguration mergedConfig)

Customize the ConfigurableApplicationContext created by this ContextLoader after bean definitions have been loaded into the context but before the context has been refreshed.

The default implementation delegates to all context customizers that have been registered with the supplied mergedConfig.

Parameters:

context - the newly created application context

mergedConfig - the merged context configuration

Since:

4.3

processLocations

public final java.lang.String[] processLocations(java.lang.Class<?> clazz,
                                                 java.lang.String... locations)

If the supplied locations are null or empty and isGenerateDefaultLocations() returns true, default locations will be generated (i.e., detected) for the specified class and the configured resource suffixes; otherwise, the supplied locations will be modified if necessary and returned.

Specified by:

processLocations in interface ContextLoader

Parameters:

clazz - the class with which the locations are associated: to be used when generating default locations

locations - the unmodified locations to use for loading the application context (can be null or empty)

Returns:

a processed array of application context resource locations

Since:

2.5

See Also:

isGenerateDefaultLocations(), generateDefaultLocations(Class), modifyLocations(Class, String...), ContextLoader.processLocations(Class, String...), processContextConfiguration(ContextConfigurationAttributes)

generateDefaultLocations

protected java.lang.String[] generateDefaultLocations(java.lang.Class<?> clazz)

Generate the default classpath resource locations array based on the supplied class.

For example, if the supplied class is com.example.MyTest, the generated locations will contain a single string with a value of "classpath:com/example/MyTest<suffix>", where <suffix> is the value of the first configured resource suffix for which the generated location actually exists in the classpath.

As of Spring 3.1, the implementation of this method adheres to the contract defined in the SmartContextLoader SPI. Specifically, this method will preemptively verify that the generated default location actually exists. If it does not exist, this method will log a warning and return an empty array.

Subclasses can override this method to implement a different default location generation strategy.

Parameters:

clazz - the class for which the default locations are to be generated

Returns:

an array of default application context resource locations

Since:

2.5

See Also:

getResourceSuffixes()

modifyLocations

protected java.lang.String[] modifyLocations(java.lang.Class<?> clazz,
                                             java.lang.String... locations)

Generate a modified version of the supplied locations array and return it.

The default implementation simply delegates to TestContextResourceUtils.convertToClasspathResourcePaths(java.lang.Class<?>, java.lang.String...).

Subclasses can override this method to implement a different location modification strategy.

Parameters:

clazz - the class with which the locations are associated

locations - the resource locations to be modified

Returns:

an array of modified application context resource locations

Since:

2.5

isGenerateDefaultLocations

protected boolean isGenerateDefaultLocations()

Determine whether or not default resource locations should be generated if the locations provided to processLocations(Class, String...) are null or empty.

As of Spring 3.1, the semantics of this method have been overloaded to include detection of either default resource locations or default configuration classes. Consequently, this method can also be used to determine whether or not default configuration classes should be detected if the classes present in the configuration attributes supplied to processContextConfiguration(ContextConfigurationAttributes) are null or empty.

Can be overridden by subclasses to change the default behavior.

Returns:

always true by default

Since:

2.5

getResourceSuffixes

protected java.lang.String[] getResourceSuffixes()

Get the suffixes to append to ApplicationContext resource locations when detecting default locations.

The default implementation simply wraps the value returned by getResourceSuffix() in a single-element array, but this can be overridden by subclasses in order to support multiple suffixes.

Returns:

the resource suffixes; never null or empty

Since:

4.1

See Also:

generateDefaultLocations(Class)

getResourceSuffix

protected abstract java.lang.String getResourceSuffix()

Get the suffix to append to ApplicationContext resource locations when detecting default locations.

Subclasses must provide an implementation of this method that returns a single suffix. Alternatively subclasses may provide a no-op implementation of this method and override getResourceSuffixes() in order to provide multiple custom suffixes.

Returns:

the resource suffix; never null or empty

Since:

2.5

See Also:

generateDefaultLocations(Class), getResourceSuffixes()