程序包 cn.taketoday.test.context

类 MergedContextConfiguration

java.lang.Object

cn.taketoday.test.context.MergedContextConfiguration

所有已实现的接口:

Serializable

直接已知子类:

AotMergedContextConfiguration, ReactiveWebMergedContextConfiguration, WebMergedContextConfiguration

public class MergedContextConfiguration
extends Object
implements Serializable

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

Merged context resource locations, annotated classes, active profiles, property resource locations, and in-lined properties represent all declared values in the test class hierarchy taking into consideration the semantics of the ContextConfiguration.inheritLocations(), ActiveProfiles.inheritProfiles(), TestPropertySource.inheritLocations(), and TestPropertySource.inheritProperties() flags.

A SmartContextLoader uses MergedContextConfiguration to load an ApplicationContext.

MergedContextConfiguration is also used by the ContextCache as the key for caching an ApplicationContext that was loaded using properties of this MergedContextConfiguration.

从以下版本开始:

4.0

作者:

Sam Brannen, Phillip Webb, Harry Yang

另请参阅:

• ContextConfiguration
• ContextHierarchy
• ActiveProfiles
• TestPropertySource
• ContextConfigurationAttributes
• SmartContextLoader.loadContext(MergedContextConfiguration)
• 序列化表格

字段概要

字段

修饰符和类型	字段	说明
private final String[]	activeProfiles
private final CacheAwareContextLoaderDelegate	cacheAwareContextLoaderDelegate
private final Class<?>[]	classes
private final Set<ContextCustomizer>	contextCustomizers
private final Set<Class<? extends cn.taketoday.context.ApplicationContextInitializer>>	contextInitializerClasses
private final ContextLoader	contextLoader
private static final Class<?>[]	EMPTY_CLASS_ARRAY
private static final Set<ContextCustomizer>	EMPTY_CONTEXT_CUSTOMIZERS
private static final Set<Class<? extends cn.taketoday.context.ApplicationContextInitializer>>	EMPTY_INITIALIZER_CLASSES
private static final String[]	EMPTY_STRING_ARRAY
private final String[]	locations
private final MergedContextConfiguration	parent
private final List<cn.taketoday.core.io.PropertySourceDescriptor>	propertySourceDescriptors
private final String[]	propertySourceLocations
private final String[]	propertySourceProperties
private static final long	serialVersionUID
private final Class<?>	testClass

构造器概要

构造器

构造器	说明
MergedContextConfiguration(MergedContextConfiguration mergedConfig)	Create a new MergedContextConfiguration instance by copying all fields from the supplied MergedContextConfiguration.
MergedContextConfiguration(Class<?> testClass, String[] locations, Class<?>[] classes, String[] activeProfiles, ContextLoader contextLoader)	Create a new MergedContextConfiguration instance for the supplied parameters.
MergedContextConfiguration(Class<?> testClass, String[] locations, Class<?>[] classes, Set<Class<? extends cn.taketoday.context.ApplicationContextInitializer>> contextInitializerClasses, String[] activeProfiles, ContextLoader contextLoader)	Create a new MergedContextConfiguration instance for the supplied parameters.
MergedContextConfiguration(Class<?> testClass, String[] locations, Class<?>[] classes, Set<Class<? extends cn.taketoday.context.ApplicationContextInitializer>> contextInitializerClasses, String[] activeProfiles, ContextLoader contextLoader, CacheAwareContextLoaderDelegate cacheAwareContextLoaderDelegate, MergedContextConfiguration parent)	Create a new MergedContextConfiguration instance for the supplied parameters.
MergedContextConfiguration(Class<?> testClass, String[] locations, Class<?>[] classes, Set<Class<? extends cn.taketoday.context.ApplicationContextInitializer>> contextInitializerClasses, String[] activeProfiles, String[] propertySourceLocations, String[] propertySourceProperties, ContextLoader contextLoader, CacheAwareContextLoaderDelegate cacheAwareContextLoaderDelegate, MergedContextConfiguration parent)	Create a new MergedContextConfiguration instance for the supplied parameters.
MergedContextConfiguration(Class<?> testClass, String[] locations, Class<?>[] classes, Set<Class<? extends cn.taketoday.context.ApplicationContextInitializer>> contextInitializerClasses, String[] activeProfiles, String[] propertySourceLocations, String[] propertySourceProperties, Set<ContextCustomizer> contextCustomizers, ContextLoader contextLoader, CacheAwareContextLoaderDelegate cacheAwareContextLoaderDelegate, MergedContextConfiguration parent)	Create a new MergedContextConfiguration instance for the supplied parameters.
MergedContextConfiguration(Class<?> testClass, String[] locations, Class<?>[] classes, Set<Class<? extends cn.taketoday.context.ApplicationContextInitializer>> contextInitializerClasses, String[] activeProfiles, List<cn.taketoday.core.io.PropertySourceDescriptor> propertySourceDescriptors, String[] propertySourceProperties, Set<ContextCustomizer> contextCustomizers, ContextLoader contextLoader, CacheAwareContextLoaderDelegate cacheAwareContextLoaderDelegate, MergedContextConfiguration parent)	Create a new MergedContextConfiguration instance for the supplied parameters.

方法概要

修饰符和类型	方法	说明
boolean	equals(Object other)	Determine if the supplied object is equal to this MergedContextConfiguration instance by comparing both objects' locations, annotated classes, context initializer classes, active profiles, property source descriptors, property source properties, context customizers, parents, and the fully qualified names of their ContextLoaders.
String[]	getActiveProfiles()	Get the merged active bean definition profiles for the test class.
Class<?>[]	getClasses()	Get the merged annotated classes for the test class.
Set<ContextCustomizer>	getContextCustomizers()	Get the merged ContextCustomizers that will be applied when the application context is loaded.
Set<Class<? extends cn.taketoday.context.ApplicationContextInitializer>>	getContextInitializerClasses()	Get the merged ApplicationContextInitializer classes for the test class.
ContextLoader	getContextLoader()	Get the resolved ContextLoader for the test class.
String[]	getLocations()	Get the merged resource locations for ApplicationContext configuration files for the test class.
MergedContextConfiguration	getParent()	Get the MergedContextConfiguration for the parent application context in a context hierarchy.
cn.taketoday.context.ApplicationContext	getParentApplicationContext()	Get the parent ApplicationContext for the context defined by this MergedContextConfiguration from the context cache.
List<cn.taketoday.core.io.PropertySourceDescriptor>	getPropertySourceDescriptors()	Get the merged descriptors for resource locations for test PropertySources for the test class.
String[]	getPropertySourceLocations()	Get the merged resource locations of properties files for the test class.
String[]	getPropertySourceProperties()	Get the merged inlined properties for the test class.
Class<?>	getTestClass()	Get the test class associated with this MergedContextConfiguration.
boolean	hasClasses()	Determine if this MergedContextConfiguration instance has class-based resources.
int	hashCode()	Generate a unique hash code for all properties of this MergedContextConfiguration excluding the test class.
boolean	hasLocations()	Determine if this MergedContextConfiguration instance has path-based context resource locations.
boolean	hasResources()	Determine if this MergedContextConfiguration instance has either path-based context resource locations or class-based resources.
protected static String	nullSafeClassName(ContextLoader contextLoader)	Generate a null-safe String representation of the supplied ContextLoader based solely on the fully qualified name of the loader or "null" if the supplied loader is null.
private static String[]	processActiveProfiles(String[] activeProfiles)
private static Class<?>[]	processClasses(Class<?>[] classes)
private static Set<ContextCustomizer>	processContextCustomizers(Set<ContextCustomizer> contextCustomizers)
private static Set<Class<? extends cn.taketoday.context.ApplicationContextInitializer>>	processContextInitializerClasses(Set<Class<? extends cn.taketoday.context.ApplicationContextInitializer>> contextInitializerClasses)
protected static String[]	processStrings(String[] array)
String	toString()	Provide a String representation of the test class, locations, annotated classes, context initializer classes, active profiles, property source descriptors, property source properties, context customizers, the name of the ContextLoader, and the parent configuration.

从类继承的方法 java.lang.Object

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

字段详细资料

serialVersionUID

private static final long serialVersionUID

另请参阅:

• 常量字段值

EMPTY_STRING_ARRAY

private static final String[] EMPTY_STRING_ARRAY

EMPTY_CLASS_ARRAY

private static final Class<?>[] EMPTY_CLASS_ARRAY

EMPTY_INITIALIZER_CLASSES

private static final Set<Class<? extends cn.taketoday.context.ApplicationContextInitializer>> EMPTY_INITIALIZER_CLASSES

EMPTY_CONTEXT_CUSTOMIZERS

private static final Set<ContextCustomizer> EMPTY_CONTEXT_CUSTOMIZERS

testClass

private final Class<?> testClass

locations

private final String[] locations

classes

private final Class<?>[] classes

contextInitializerClasses

private final Set<Class<? extends cn.taketoday.context.ApplicationContextInitializer>> contextInitializerClasses

activeProfiles

private final String[] activeProfiles

propertySourceDescriptors

private final List<cn.taketoday.core.io.PropertySourceDescriptor> propertySourceDescriptors

propertySourceLocations

private final String[] propertySourceLocations

propertySourceProperties

private final String[] propertySourceProperties

contextCustomizers

private final Set<ContextCustomizer> contextCustomizers

contextLoader

@Nullable
private final ContextLoader contextLoader

cacheAwareContextLoaderDelegate

@Nullable
private final CacheAwareContextLoaderDelegate cacheAwareContextLoaderDelegate

parent

@Nullable
private final MergedContextConfiguration parent

构造器详细资料

MergedContextConfiguration

public MergedContextConfiguration(Class<?> testClass,
 @Nullable
 String[] locations,
 @Nullable
 Class<?>[] classes,
 @Nullable
 String[] activeProfiles,
 ContextLoader contextLoader)

Create a new MergedContextConfiguration instance for the supplied parameters.

参数:

testClass - the test class for which the configuration was merged

locations - the merged context resource locations

classes - the merged annotated classes

activeProfiles - the merged active bean definition profiles

contextLoader - the resolved ContextLoader

MergedContextConfiguration

public MergedContextConfiguration(Class<?> testClass,
 @Nullable
 String[] locations,
 @Nullable
 Class<?>[] classes,
 @Nullable
 Set<Class<? extends cn.taketoday.context.ApplicationContextInitializer>> contextInitializerClasses,
 @Nullable
 String[] activeProfiles,
 ContextLoader contextLoader)

Create a new MergedContextConfiguration instance for the supplied 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

contextLoader - the resolved ContextLoader

MergedContextConfiguration

public MergedContextConfiguration(Class<?> testClass,
 @Nullable
 String[] locations,
 @Nullable
 Class<?>[] classes,
 @Nullable
 Set<Class<? extends cn.taketoday.context.ApplicationContextInitializer>> contextInitializerClasses,
 @Nullable
 String[] activeProfiles,
 ContextLoader contextLoader,
 @Nullable
 CacheAwareContextLoaderDelegate cacheAwareContextLoaderDelegate,
 @Nullable
 MergedContextConfiguration parent)

Create a new MergedContextConfiguration instance for the supplied 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

contextLoader - the resolved ContextLoader

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

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

MergedContextConfiguration

public MergedContextConfiguration(MergedContextConfiguration mergedConfig)

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

MergedContextConfiguration

public MergedContextConfiguration(Class<?> testClass,
 @Nullable
 String[] locations,
 @Nullable
 Class<?>[] classes,
 @Nullable
 Set<Class<? extends cn.taketoday.context.ApplicationContextInitializer>> contextInitializerClasses,
 @Nullable
 String[] activeProfiles,
 @Nullable
 String[] propertySourceLocations,
 @Nullable
 String[] propertySourceProperties,
 ContextLoader contextLoader,
 @Nullable
 CacheAwareContextLoaderDelegate cacheAwareContextLoaderDelegate,
 @Nullable
 MergedContextConfiguration parent)

Create a new MergedContextConfiguration 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. Furthermore, active profiles will be sorted, and duplicate profiles will be removed.

参数:

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

contextLoader - the resolved ContextLoader

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

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

MergedContextConfiguration

public MergedContextConfiguration(Class<?> testClass,
 @Nullable
 String[] locations,
 @Nullable
 Class<?>[] classes,
 @Nullable
 Set<Class<? extends cn.taketoday.context.ApplicationContextInitializer>> contextInitializerClasses,
 @Nullable
 String[] activeProfiles,
 @Nullable
 String[] propertySourceLocations,
 @Nullable
 String[] propertySourceProperties,
 @Nullable
 Set<ContextCustomizer> contextCustomizers,
 ContextLoader contextLoader,
 @Nullable
 CacheAwareContextLoaderDelegate cacheAwareContextLoaderDelegate,
 @Nullable
 MergedContextConfiguration parent)

Create a new MergedContextConfiguration 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. Furthermore, active profiles will be sorted, and duplicate profiles will be removed.

参数:

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

contextLoader - the resolved ContextLoader

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

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

MergedContextConfiguration

public MergedContextConfiguration(Class<?> testClass,
 @Nullable
 String[] locations,
 @Nullable
 Class<?>[] classes,
 @Nullable
 Set<Class<? extends cn.taketoday.context.ApplicationContextInitializer>> contextInitializerClasses,
 @Nullable
 String[] activeProfiles,
 List<cn.taketoday.core.io.PropertySourceDescriptor> propertySourceDescriptors,
 @Nullable
 String[] propertySourceProperties,
 @Nullable
 Set<ContextCustomizer> contextCustomizers,
 @Nullable
 ContextLoader contextLoader,
 @Nullable
 CacheAwareContextLoaderDelegate cacheAwareContextLoaderDelegate,
 @Nullable
 MergedContextConfiguration parent)

Create a new MergedContextConfiguration instance for the supplied parameters.

If a null value is supplied for locations, classes, activeProfiles, 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. Furthermore, active profiles will be sorted, and duplicate profiles will be removed.

参数:

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

propertySourceDescriptors - the merged property source descriptors

propertySourceProperties - the merged inlined properties

contextCustomizers - the context customizers

contextLoader - the resolved ContextLoader

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

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

方法详细资料

getTestClass

public Class<?> getTestClass()

Get the test class associated with this MergedContextConfiguration.

getLocations

public String[] getLocations()

Get the merged resource locations for ApplicationContext configuration files for the test class.

Context resource locations typically represent XML configuration files or Groovy scripts.

getClasses

public Class<?>[] getClasses()

Get the merged annotated classes for the test class.

hasLocations

public boolean hasLocations()

Determine if this MergedContextConfiguration instance has path-based context resource locations.

返回:

true if the locations array is not empty

另请参阅:

• hasResources()
• hasClasses()

hasClasses

public boolean hasClasses()

Determine if this MergedContextConfiguration instance has class-based resources.

返回:

true if the classes array is not empty

另请参阅:

• hasResources()
• hasLocations()

hasResources

public boolean hasResources()

Determine if this MergedContextConfiguration instance has either path-based context resource locations or class-based resources.

返回:

true if either the locations or the classes array is not empty

另请参阅:

• hasLocations()
• hasClasses()

getContextInitializerClasses

public Set<Class<? extends cn.taketoday.context.ApplicationContextInitializer>> getContextInitializerClasses()

Get the merged ApplicationContextInitializer classes for the test class.

getActiveProfiles

public String[] getActiveProfiles()

Get the merged active bean definition profiles for the test class.

另请参阅:

• ActiveProfiles

getPropertySourceDescriptors

public List<cn.taketoday.core.io.PropertySourceDescriptor> getPropertySourceDescriptors()

Get the merged descriptors for resource locations for test PropertySources for the test class.

Properties will be loaded into the Environment's set of PropertySources.

另请参阅:

• TestPropertySource.locations()
• TestPropertySource.encoding()
• TestPropertySource.factory()

getPropertySourceLocations

public String[] getPropertySourceLocations()

Get the merged resource locations of properties files for the test class.

另请参阅:

• TestPropertySource.locations()
• Properties

getPropertySourceProperties

public String[] getPropertySourceProperties()

Get the merged inlined properties for the test class.

Properties will be loaded into the Environment's set of PropertySources.

另请参阅:

• TestPropertySource.properties()
• Properties

getContextCustomizers

public Set<ContextCustomizer> getContextCustomizers()

Get the merged ContextCustomizers that will be applied when the application context is loaded.

getContextLoader

@Nullable
public ContextLoader getContextLoader()

Get the resolved ContextLoader for the test class.

getParent

@Nullable
public MergedContextConfiguration getParent()

Get the MergedContextConfiguration for the parent application context in a context hierarchy.

返回:

the parent configuration or null if there is no parent

另请参阅:

• getParentApplicationContext()

getParentApplicationContext

@Nullable
public cn.taketoday.context.ApplicationContext getParentApplicationContext()

Get the parent ApplicationContext for the context defined by this MergedContextConfiguration from the context cache.

If the parent context has not yet been loaded, it will be loaded, stored in the cache, and then returned.

返回:

the parent ApplicationContext or null if there is no parent

另请参阅:

• getParent()

equals

public boolean equals(@Nullable
 Object other)

Determine if the supplied object is equal to this MergedContextConfiguration instance by comparing both objects' locations, annotated classes, context initializer classes, active profiles, property source descriptors, property source properties, context customizers, parents, and the fully qualified names of their ContextLoaders.

覆盖:

equals 在类中 Object

hashCode

public int hashCode()

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

覆盖:

hashCode 在类中 Object

toString

public String toString()

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

覆盖:

toString 在类中 Object

processStrings

protected static String[] processStrings(@Nullable
 String[] array)

processClasses

private static Class<?>[] processClasses(@Nullable
 Class<?>[] classes)

processContextInitializerClasses

private static Set<Class<? extends cn.taketoday.context.ApplicationContextInitializer>> processContextInitializerClasses(@Nullable
 Set<Class<? extends cn.taketoday.context.ApplicationContextInitializer>> contextInitializerClasses)

processContextCustomizers

private static Set<ContextCustomizer> processContextCustomizers(@Nullable
 Set<ContextCustomizer> contextCustomizers)

processActiveProfiles

private static String[] processActiveProfiles(@Nullable
 String[] activeProfiles)

nullSafeClassName

protected static String nullSafeClassName(@Nullable
 ContextLoader contextLoader)

Generate a null-safe String representation of the supplied ContextLoader based solely on the fully qualified name of the loader or "null" if the supplied loader is null.