程序包 cn.taketoday.test.context.support

类 AbstractTestContextBootstrapper

java.lang.Object

cn.taketoday.test.context.support.AbstractTestContextBootstrapper

所有已实现的接口:

TestContextBootstrapper

直接已知子类:

DefaultTestContextBootstrapper

public abstract class AbstractTestContextBootstrapper
extends Object
implements TestContextBootstrapper

Abstract implementation of the TestContextBootstrapper interface which provides most of the behavior required by a bootstrapper.

Concrete subclasses typically will only need to provide implementations for the following methods:

• getDefaultContextLoaderClass(java.lang.Class<?>)
• processMergedContextConfiguration(cn.taketoday.test.context.MergedContextConfiguration)

To plug in custom ContextCache support, override getCacheAwareContextLoaderDelegate().

从以下版本开始:

4.0

作者:

Sam Brannen, Juergen Hoeller, Phillip Webb, Harry Yang

字段概要

字段

修饰符和类型	字段	说明
private BootstrapContext	bootstrapContext
private static final cn.taketoday.logging.Logger	log

构造器概要

构造器

构造器	说明
AbstractTestContextBootstrapper()

方法概要

修饰符和类型	方法	说明
private static boolean	areAllEmpty(Collection<?>... collections)
private MergedContextConfiguration	buildDefaultMergedContextConfiguration(Class<?> testClass, CacheAwareContextLoaderDelegate cacheAwareContextLoaderDelegate)
final MergedContextConfiguration	buildMergedContextConfiguration()	Build the merged context configuration for the test class in the BootstrapContext associated with this bootstrapper.
private MergedContextConfiguration	buildMergedContextConfiguration(Class<?> testClass, List<ContextConfigurationAttributes> configAttributesList, MergedContextConfiguration parentConfig, CacheAwareContextLoaderDelegate cacheAwareContextLoaderDelegate, boolean requireLocationsClassesOrInitializers)	Build the merged context configuration for the supplied testClass, context configuration attributes, and parent context configuration.
TestContext	buildTestContext()	Build a new DefaultTestContext using the test class in the BootstrapContext associated with this bootstrapper and by delegating to buildMergedContextConfiguration() and getCacheAwareContextLoaderDelegate().
private static List<String>	classSimpleNames(Collection<?> components)
BootstrapContext	getBootstrapContext()	Get the BootstrapContext associated with this bootstrapper.
protected CacheAwareContextLoaderDelegate	getCacheAwareContextLoaderDelegate()	Get the CacheAwareContextLoaderDelegate to use for transparent interaction with the ContextCache.
protected List<ContextCustomizerFactory>	getContextCustomizerFactories()	Get the ContextCustomizerFactory instances for this bootstrapper.
private List<ContextCustomizerFactory>	getContextCustomizerFactories(Class<?> testClass)
private Set<ContextCustomizer>	getContextCustomizers(Class<?> testClass, List<ContextConfigurationAttributes> configAttributes)
protected abstract Class<? extends ContextLoader>	getDefaultContextLoaderClass(Class<?> testClass)	Determine the default ContextLoader class to use for the supplied test class.
protected List<TestExecutionListener>	getDefaultTestExecutionListeners()	Get the default TestExecutionListeners for this bootstrapper.
final List<TestExecutionListener>	getTestExecutionListeners()	Get a list of newly instantiated TestExecutionListeners for the test class in the BootstrapContext associated with this bootstrapper.
private <T> List<T>	instantiateComponents(Class<T> componentType, Class<? extends T>... classes)
private List<ContextCustomizerFactory>	instantiateCustomizerFactories(Class<? extends ContextCustomizerFactory>... classes)
private List<TestExecutionListener>	instantiateListeners(Class<? extends TestExecutionListener>... classes)
protected MergedContextConfiguration	processMergedContextConfiguration(MergedContextConfiguration mergedConfig)	Process the supplied, newly instantiated MergedContextConfiguration instance.
protected ContextLoader	resolveContextLoader(Class<?> testClass, List<ContextConfigurationAttributes> configAttributesList)	Resolve the ContextLoader class to use for the supplied list of ContextConfigurationAttributes and then instantiate and return that ContextLoader.
protected Class<? extends ContextLoader>	resolveExplicitContextLoaderClass(List<ContextConfigurationAttributes> configAttributesList)	Resolve the ContextLoader class to use for the supplied list of ContextConfigurationAttributes.
void	setBootstrapContext(BootstrapContext bootstrapContext)	Set the BootstrapContext to be used by this bootstrapper.

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

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

字段详细资料

log

private static final cn.taketoday.logging.Logger log

bootstrapContext

@Nullable
private BootstrapContext bootstrapContext

构造器详细资料

AbstractTestContextBootstrapper

public AbstractTestContextBootstrapper()

方法详细资料

setBootstrapContext

public void setBootstrapContext(BootstrapContext bootstrapContext)

从接口复制的说明: TestContextBootstrapper

Set the BootstrapContext to be used by this bootstrapper.

指定者:

setBootstrapContext 在接口中 TestContextBootstrapper

getBootstrapContext

public BootstrapContext getBootstrapContext()

从接口复制的说明: TestContextBootstrapper

Get the BootstrapContext associated with this bootstrapper.

指定者:

getBootstrapContext 在接口中 TestContextBootstrapper

buildTestContext

public TestContext buildTestContext()

Build a new DefaultTestContext using the test class in the BootstrapContext associated with this bootstrapper and by delegating to buildMergedContextConfiguration() and getCacheAwareContextLoaderDelegate().

Concrete subclasses may choose to override this method to return a custom TestContext implementation.

指定者:

buildTestContext 在接口中 TestContextBootstrapper

返回:

a new TestContext, never null

另请参阅:

• TestContextBootstrapper.buildMergedContextConfiguration()

getTestExecutionListeners

public final List<TestExecutionListener> getTestExecutionListeners()

从接口复制的说明: TestContextBootstrapper

Get a list of newly instantiated TestExecutionListeners for the test class in the BootstrapContext associated with this bootstrapper.

If @TestExecutionListeners is not present on the test class in the BootstrapContext, default listeners should be returned. Furthermore, default listeners must be sorted using AnnotationAwareOrderComparator.

Concrete implementations are free to determine what comprises the set of default listeners. However, by default, the Infra TestContext Framework will use the TodayStrategies mechanism to look up all TestExecutionListener class names configured in all META-INF/today.strategies files on the classpath.

The inheritListeners flag of @TestExecutionListeners must be taken into consideration. Specifically, if the inheritListeners flag is set to true, listeners declared for a given test class must be appended to the end of the list of listeners declared in superclasses.

指定者:

getTestExecutionListeners 在接口中 TestContextBootstrapper

返回:

a list of TestExecutionListener instances

instantiateListeners

private List<TestExecutionListener> instantiateListeners(Class<? extends TestExecutionListener>... classes)

getDefaultTestExecutionListeners

protected List<TestExecutionListener> getDefaultTestExecutionListeners()

Get the default TestExecutionListeners for this bootstrapper.

The default implementation delegates to TestContextFactoriesUtils.loadFactoryImplementations(Class).

This method is invoked by getTestExecutionListeners().

返回:

an unmodifiable list of default TestExecutionListener instances

buildMergedContextConfiguration

public final MergedContextConfiguration buildMergedContextConfiguration()

Build the merged context configuration for the test class in the BootstrapContext associated with this bootstrapper.

Implementations must take the following into account when building the merged configuration:

• Context hierarchies declared via @ContextHierarchy and @ContextConfiguration
• Active bean definition profiles declared via @ActiveProfiles
• Context initializers declared via ContextConfiguration.initializers()
• Test property sources declared via @TestPropertySource

Consult the Javadoc for the aforementioned annotations for details on the required semantics.

Note that the implementation of TestContextBootstrapper.buildTestContext() should typically delegate to this method when constructing the TestContext.

When determining which ContextLoader to use for a given test class, the following algorithm should be used:

1. If a ContextLoader class has been explicitly declared via ContextConfiguration.loader(), use it.
2. Otherwise, concrete implementations are free to determine which ContextLoader class to use as a default.

指定者:

buildMergedContextConfiguration 在接口中 TestContextBootstrapper

返回:

the merged context configuration, never null

另请参阅:

• TestContextBootstrapper.buildTestContext()

buildDefaultMergedContextConfiguration

private MergedContextConfiguration buildDefaultMergedContextConfiguration(Class<?> testClass,
 CacheAwareContextLoaderDelegate cacheAwareContextLoaderDelegate)

buildMergedContextConfiguration

private MergedContextConfiguration buildMergedContextConfiguration(Class<?> testClass,
 List<ContextConfigurationAttributes> configAttributesList,
 @Nullable
 MergedContextConfiguration parentConfig,
 CacheAwareContextLoaderDelegate cacheAwareContextLoaderDelegate,
 boolean requireLocationsClassesOrInitializers)

Build the merged context configuration for the supplied testClass, context configuration attributes, and parent context configuration.

参数:

testClass - the test class for which the MergedContextConfiguration should be built (must not be null)

configAttributesList - the list of context configuration attributes for the specified test class, ordered bottom-up (i.e., as if we were traversing up the class hierarchy and enclosing class hierarchy); never null or empty

parentConfig - the merged context configuration for the parent application context in a context hierarchy, or null if there is no parent

cacheAwareContextLoaderDelegate - the cache-aware context loader delegate to be passed to the MergedContextConfiguration constructor

requireLocationsClassesOrInitializers - whether locations, classes, or initializers are required; typically true but may be set to false if the configured loader supports empty configuration

返回:

the merged context configuration

另请参阅:

• resolveContextLoader(java.lang.Class<?>, java.util.List<cn.taketoday.test.context.ContextConfigurationAttributes>)
• ContextLoaderUtils.resolveContextConfigurationAttributes(java.lang.Class<?>)
• SmartContextLoader.processContextConfiguration(cn.taketoday.test.context.ContextConfigurationAttributes)
• ContextLoader.processLocations(java.lang.Class<?>, java.lang.String...)
• ActiveProfilesUtils.resolveActiveProfiles(java.lang.Class<?>)
• ApplicationContextInitializerUtils.resolveInitializerClasses(java.util.List<cn.taketoday.test.context.ContextConfigurationAttributes>)
• MergedContextConfiguration

getContextCustomizers

private Set<ContextCustomizer> getContextCustomizers(Class<?> testClass,
 List<ContextConfigurationAttributes> configAttributes)

getContextCustomizerFactories

private List<ContextCustomizerFactory> getContextCustomizerFactories(Class<?> testClass)

getContextCustomizerFactories

protected List<ContextCustomizerFactory> getContextCustomizerFactories()

Get the ContextCustomizerFactory instances for this bootstrapper.

The default implementation delegates to TestContextFactoriesUtils.loadFactoryImplementations(Class).

instantiateCustomizerFactories

private List<ContextCustomizerFactory> instantiateCustomizerFactories(Class<? extends ContextCustomizerFactory>... classes)

instantiateComponents

private <T> List<T> instantiateComponents(Class<T> componentType,
 Class<? extends T>... classes)

resolveContextLoader

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

Resolve the ContextLoader class to use for the supplied list of ContextConfigurationAttributes and then instantiate and return that ContextLoader.

If the user has not explicitly declared which loader to use, the value returned from getDefaultContextLoaderClass(java.lang.Class<?>) will be used as the default context loader class. For details on the class resolution process, see resolveExplicitContextLoaderClass(java.util.List<cn.taketoday.test.context.ContextConfigurationAttributes>) and getDefaultContextLoaderClass(java.lang.Class<?>).

参数:

testClass - the test class for which the ContextLoader should be resolved; must not be null

configAttributesList - the list of configuration attributes to process; must not be null; must be ordered bottom-up (i.e., as if we were traversing up the class hierarchy and enclosing class hierarchy)

返回:

the resolved ContextLoader for the supplied testClass (never null)

抛出:

IllegalStateException - if getDefaultContextLoaderClass(Class) returns null

resolveExplicitContextLoaderClass

@Nullable
protected Class<? extends ContextLoader> resolveExplicitContextLoaderClass(List<ContextConfigurationAttributes> configAttributesList)

Resolve the ContextLoader class to use for the supplied list of ContextConfigurationAttributes.

Beginning with the first level in the context configuration attributes hierarchy:

1. If the contextLoaderClass property of ContextConfigurationAttributes is configured with an explicit class, that class will be returned.
2. If an explicit ContextLoader class is not specified at the current level in the hierarchy, traverse to the next level in the hierarchy and return to step #1.

参数:

configAttributesList - the list of configuration attributes to process; must not be null; must be ordered bottom-up (i.e., as if we were traversing up the class hierarchy and enclosing class hierarchy)

返回:

the ContextLoader class to use for the supplied configuration attributes, or null if no explicit loader is found

抛出:

IllegalArgumentException - if supplied configuration attributes are null or empty

getCacheAwareContextLoaderDelegate

protected CacheAwareContextLoaderDelegate getCacheAwareContextLoaderDelegate()

Get the CacheAwareContextLoaderDelegate to use for transparent interaction with the ContextCache.

The default implementation delegates to getBootstrapContext().getCacheAwareContextLoaderDelegate() and the default one will load ApplicationContextFailureProcessor via the service loading mechanism.

Concrete subclasses may choose to override this method to return a custom CacheAwareContextLoaderDelegate implementation with custom ContextCache support.

返回:

the context loader delegate (never null)

另请参阅:

• ApplicationContextFailureProcessor

getDefaultContextLoaderClass

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

Determine the default ContextLoader class to use for the supplied test class.

The class returned by this method will only be used if a ContextLoader class has not been explicitly declared via ContextConfiguration.loader().

参数:

testClass - the test class for which to retrieve the default ContextLoader class

返回:

the default ContextLoader class for the supplied test class (never null)

processMergedContextConfiguration

protected MergedContextConfiguration processMergedContextConfiguration(MergedContextConfiguration mergedConfig)

Process the supplied, newly instantiated MergedContextConfiguration instance.

The returned MergedContextConfiguration instance may be a wrapper around or a replacement for the original.

The default implementation simply returns the supplied instance unmodified.

Concrete subclasses may choose to return a specialized subclass of MergedContextConfiguration based on properties in the supplied instance.

参数:

mergedConfig - the MergedContextConfiguration to process; never null

返回:

a fully initialized MergedContextConfiguration; never null

classSimpleNames

private static List<String> classSimpleNames(Collection<?> components)

areAllEmpty

private static boolean areAllEmpty(Collection<?>... collections)