org.springframework.test.context.web

Class WebMergedContextConfiguration

java.lang.Object

org.springframework.test.context.MergedContextConfiguration

org.springframework.test.context.web.WebMergedContextConfiguration

All Implemented Interfaces:

Serializable

public class WebMergedContextConfiguration
extends MergedContextConfiguration

WebMergedContextConfiguration encapsulates the merged context configuration declared on a test class and all of its superclasses via @ContextConfiguration, @WebAppConfiguration, and @ActiveProfiles.

WebMergedContextConfiguration extends the contract of MergedContextConfiguration by adding support for the resource base path configured via @WebAppConfiguration. This allows the TestContext to properly cache the corresponding WebApplicationContext that was loaded using properties of this WebMergedContextConfiguration.

Since:

3.2

Author:

Sam Brannen

See Also:

WebAppConfiguration, MergedContextConfiguration, ContextConfiguration, ActiveProfiles, ContextConfigurationAttributes, SmartContextLoader.loadContext(MergedContextConfiguration), Serialized Form

Constructor Summary

Constructors

Constructor and Description
WebMergedContextConfiguration(Class<?> testClass, String[] locations, Class<?>[] classes, Set<Class<? extends ApplicationContextInitializer<? extends ConfigurableApplicationContext>>> contextInitializerClasses, String[] activeProfiles, String[] propertySourceLocations, String[] propertySourceProperties, Set<ContextCustomizer> contextCustomizers, String resourceBasePath, ContextLoader contextLoader, CacheAwareContextLoaderDelegate cacheAwareContextLoaderDelegate, MergedContextConfiguration parent) Create a new WebMergedContextConfiguration instance for the supplied parameters.
WebMergedContextConfiguration(Class<?> testClass, String[] locations, Class<?>[] classes, Set<Class<? extends ApplicationContextInitializer<? extends ConfigurableApplicationContext>>> contextInitializerClasses, String[] activeProfiles, String[] propertySourceLocations, String[] propertySourceProperties, String resourceBasePath, ContextLoader contextLoader, CacheAwareContextLoaderDelegate cacheAwareContextLoaderDelegate, MergedContextConfiguration parent) Create a new WebMergedContextConfiguration instance for the supplied parameters.
WebMergedContextConfiguration(Class<?> testClass, String[] locations, Class<?>[] classes, Set<Class<? extends ApplicationContextInitializer<? extends ConfigurableApplicationContext>>> contextInitializerClasses, String[] activeProfiles, String resourceBasePath, ContextLoader contextLoader, CacheAwareContextLoaderDelegate cacheAwareContextLoaderDelegate, MergedContextConfiguration parent) Deprecated. as of Spring 4.1, use WebMergedContextConfiguration(Class, String[], Class[], Set, String[], String[], String[], String, ContextLoader, CacheAwareContextLoaderDelegate, MergedContextConfiguration) instead.
WebMergedContextConfiguration(MergedContextConfiguration mergedConfig, String resourceBasePath) Create a new WebMergedContextConfiguration instance by copying all properties from the supplied MergedContextConfiguration.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object other) Determine if the supplied object is equal to this WebMergedContextConfiguration instance by comparing both object's locations, annotated classes, context initializer classes, active profiles, resource base path, parents, and the fully qualified names of their ContextLoaders.
String	getResourceBasePath() Get the resource path to the root directory of the web application for the test class, configured via @WebAppConfiguration.
int	hashCode() Generate a unique hash code for all properties of this WebMergedContextConfiguration excluding the test class.
String	toString() Provide a String representation of the test class, locations, annotated classes, context initializer classes, active profiles, property source locations, property source properties, context customizers, resource base path, the name of the ContextLoader, and the parent configuration.

Methods inherited from class org.springframework.test.context.MergedContextConfiguration

getActiveProfiles, getClasses, getContextCustomizers, getContextInitializerClasses, getContextLoader, getLocations, getParent, getParentApplicationContext, getPropertySourceLocations, getPropertySourceProperties, getTestClass, hasClasses, hasLocations, hasResources, nullSafeToString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

WebMergedContextConfiguration

@Deprecated
public WebMergedContextConfiguration(Class<?> testClass,
                                                 String[] locations,
                                                 Class<?>[] classes,
                                                 Set<Class<? extends ApplicationContextInitializer<? extends ConfigurableApplicationContext>>> contextInitializerClasses,
                                                 String[] activeProfiles,
                                                 String resourceBasePath,
                                                 ContextLoader contextLoader,
                                                 CacheAwareContextLoaderDelegate cacheAwareContextLoaderDelegate,
                                                 MergedContextConfiguration parent)

Deprecated. as of Spring 4.1, use WebMergedContextConfiguration(Class, String[], Class[], Set, String[], String[], String[], String, ContextLoader, CacheAwareContextLoaderDelegate, MergedContextConfiguration) instead.

Create a new WebMergedContextConfiguration instance for the supplied parameters.

Delegates to WebMergedContextConfiguration(Class, String[], Class[], Set, String[], String[], String[], String, ContextLoader, CacheAwareContextLoaderDelegate, MergedContextConfiguration).

Parameters:

testClass - the test class for which the configuration was merged

locations - the merged resource locations

classes - the merged annotated classes

contextInitializerClasses - the merged context initializer classes

activeProfiles - the merged active bean definition profiles

resourceBasePath - the resource path to the root directory of the web application

contextLoader - the resolved ContextLoader

cacheAwareContextLoaderDelegate - a cache-aware context loader delegate with which to retrieve the parent context

parent - the parent configuration or null if there is no parent

Since:

3.2.2

WebMergedContextConfiguration

public WebMergedContextConfiguration(MergedContextConfiguration mergedConfig,
                                     String resourceBasePath)

Create a new WebMergedContextConfiguration instance by copying all properties from the supplied MergedContextConfiguration.

If an empty value is supplied for the resourceBasePath an empty string will be used.

Parameters:

resourceBasePath - the resource path to the root directory of the web application

Since:

4.1

WebMergedContextConfiguration

public WebMergedContextConfiguration(Class<?> testClass,
                                     String[] locations,
                                     Class<?>[] classes,
                                     Set<Class<? extends ApplicationContextInitializer<? extends ConfigurableApplicationContext>>> contextInitializerClasses,
                                     String[] activeProfiles,
                                     String[] propertySourceLocations,
                                     String[] propertySourceProperties,
                                     String resourceBasePath,
                                     ContextLoader contextLoader,
                                     CacheAwareContextLoaderDelegate cacheAwareContextLoaderDelegate,
                                     MergedContextConfiguration parent)

Create a new WebMergedContextConfiguration instance for the supplied parameters.

If a null value is supplied for locations, classes, activeProfiles, propertySourceLocations, or propertySourceProperties an empty array will be stored instead. If a null value is supplied for the contextInitializerClasses an empty set will be stored instead. If an empty value is supplied for the resourceBasePath an empty string will be used. Furthermore, active profiles will be sorted, and duplicate profiles will be removed.

Parameters:

testClass - the test class for which the configuration was merged

locations - the merged resource locations

classes - the merged annotated classes

contextInitializerClasses - the merged context initializer classes

activeProfiles - the merged active bean definition profiles

propertySourceLocations - the merged PropertySource locations

propertySourceProperties - the merged PropertySource properties

resourceBasePath - the resource path to the root directory of the web application

contextLoader - the resolved ContextLoader

cacheAwareContextLoaderDelegate - a cache-aware context loader delegate with which to retrieve the parent context

parent - the parent configuration or null if there is no parent

Since:

4.1

WebMergedContextConfiguration

public WebMergedContextConfiguration(Class<?> testClass,
                                     String[] locations,
                                     Class<?>[] classes,
                                     Set<Class<? extends ApplicationContextInitializer<? extends ConfigurableApplicationContext>>> contextInitializerClasses,
                                     String[] activeProfiles,
                                     String[] propertySourceLocations,
                                     String[] propertySourceProperties,
                                     Set<ContextCustomizer> contextCustomizers,
                                     String resourceBasePath,
                                     ContextLoader contextLoader,
                                     CacheAwareContextLoaderDelegate cacheAwareContextLoaderDelegate,
                                     MergedContextConfiguration parent)

Create a new WebMergedContextConfiguration instance for the supplied parameters.

If a null value is supplied for locations, classes, activeProfiles, propertySourceLocations, or propertySourceProperties an empty array will be stored instead. If a null value is supplied for contextInitializerClasses or contextCustomizers, an empty set will be stored instead. If an empty value is supplied for the resourceBasePath an empty string will be used. Furthermore, active profiles will be sorted, and duplicate profiles will be removed.

Parameters:

testClass - the test class for which the configuration was merged

locations - the merged context resource locations

classes - the merged annotated classes

contextInitializerClasses - the merged context initializer classes

activeProfiles - the merged active bean definition profiles

propertySourceLocations - the merged PropertySource locations

propertySourceProperties - the merged PropertySource properties

contextCustomizers - the context customizers

resourceBasePath - the resource path to the root directory of the web application

contextLoader - the resolved ContextLoader

cacheAwareContextLoaderDelegate - a cache-aware context loader delegate with which to retrieve the parent context

parent - the parent configuration or null if there is no parent

Since:

4.3

Method Detail

getResourceBasePath

public String getResourceBasePath()

Get the resource path to the root directory of the web application for the test class, configured via @WebAppConfiguration.

See Also:

WebAppConfiguration

equals

public boolean equals(Object other)

Determine if the supplied object is equal to this WebMergedContextConfiguration instance by comparing both object's locations, annotated classes, context initializer classes, active profiles, resource base path, parents, and the fully qualified names of their ContextLoaders.

Overrides:

equals in class MergedContextConfiguration

hashCode

public int hashCode()

Generate a unique hash code for all properties of this WebMergedContextConfiguration excluding the test class.

Overrides:

hashCode in class MergedContextConfiguration

toString

public String toString()

Provide a String representation of the test class, locations, annotated classes, context initializer classes, active profiles, property source locations, property source properties, context customizers, resource base path, the name of the ContextLoader, and the parent configuration.

Overrides:

toString in class MergedContextConfiguration