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

类 DefaultCacheAwareContextLoaderDelegate

java.lang.Object

cn.taketoday.test.context.cache.DefaultCacheAwareContextLoaderDelegate

所有已实现的接口:

CacheAwareContextLoaderDelegate

public class DefaultCacheAwareContextLoaderDelegate
extends Object
implements CacheAwareContextLoaderDelegate

Default implementation of the CacheAwareContextLoaderDelegate interface.

To use a static DefaultContextCache, invoke the DefaultCacheAwareContextLoaderDelegate() constructor; otherwise, invoke the DefaultCacheAwareContextLoaderDelegate(ContextCache) and provide a custom ContextCache implementation.

从以下版本开始:

4.0

作者:

Sam Brannen, Harry Yang

字段概要

字段

修饰符和类型	字段	说明
private final AotTestContextInitializers	aotTestContextInitializers
private final ContextCache	contextCache
private final List<ApplicationContextFailureProcessor>	contextFailureProcessors
(专用程序包) static final ContextCache	defaultContextCache	Default static cache of Infra application contexts.
private final int	failureThreshold	The configured failure threshold for errors encountered while attempting to load an ApplicationContext.
private static final cn.taketoday.logging.Logger	logger

从接口继承的字段 cn.taketoday.test.context.CacheAwareContextLoaderDelegate

CONTEXT_FAILURE_THRESHOLD_PROPERTY_NAME, DEFAULT_CACHE_AWARE_CONTEXT_LOADER_DELEGATE_PROPERTY_NAME, DEFAULT_CONTEXT_FAILURE_THRESHOLD

构造器概要

构造器

限定符	构造器	说明
	DefaultCacheAwareContextLoaderDelegate()	Construct a new DefaultCacheAwareContextLoaderDelegate using a static DefaultContextCache.
	DefaultCacheAwareContextLoaderDelegate(ContextCache contextCache)	Construct a new DefaultCacheAwareContextLoaderDelegate using the supplied ContextCache and the default or user-configured context failure threshold.
private	DefaultCacheAwareContextLoaderDelegate(ContextCache contextCache, int failureThreshold)	Construct a new DefaultCacheAwareContextLoaderDelegate using the supplied ContextCache and context failure threshold.

方法概要

修饰符和类型	方法	说明
void	closeContext(MergedContextConfiguration mergedConfig, DirtiesContext.HierarchyMode hierarchyMode)	Remove the application context for the supplied MergedContextConfiguration from the ContextCache and close it if it is an instance of ConfigurableApplicationContext.
protected ContextCache	getContextCache()	Get the ContextCache used by this context loader delegate.
private ContextLoader	getContextLoader(MergedContextConfiguration mergedConfig)
boolean	isContextLoaded(MergedContextConfiguration mergedConfig)	Determine if the application context for the supplied MergedContextConfiguration has been loaded (i.e., is present in the ContextCache).
cn.taketoday.context.ApplicationContext	loadContext(MergedContextConfiguration mergedConfig)	Load the application context for the supplied MergedContextConfiguration by delegating to the ContextLoader configured in the given MergedContextConfiguration.
protected cn.taketoday.context.ApplicationContext	loadContextInAotMode(AotMergedContextConfiguration aotMergedConfig)
protected cn.taketoday.context.ApplicationContext	loadContextInternal(MergedContextConfiguration mergedConfig)	Load the ApplicationContext for the supplied merged context configuration.
private MergedContextConfiguration	replaceIfNecessary(MergedContextConfiguration mergedConfig)	If the test class associated with the supplied MergedContextConfiguration has an AOT-optimized ApplicationContext, this method will create an AotMergedContextConfiguration to replace the provided MergedContextConfiguration.

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

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

字段详细资料

logger

private static final cn.taketoday.logging.Logger logger

defaultContextCache

static final ContextCache defaultContextCache

Default static cache of Infra application contexts.

contextFailureProcessors

private final List<ApplicationContextFailureProcessor> contextFailureProcessors

aotTestContextInitializers

private final AotTestContextInitializers aotTestContextInitializers

contextCache

private final ContextCache contextCache

failureThreshold

private final int failureThreshold

The configured failure threshold for errors encountered while attempting to load an ApplicationContext.

构造器详细资料

DefaultCacheAwareContextLoaderDelegate

public DefaultCacheAwareContextLoaderDelegate()

Construct a new DefaultCacheAwareContextLoaderDelegate using a static DefaultContextCache.

The default cache is static so that each context can be cached and reused for all subsequent tests that declare the same unique context configuration within the same JVM process.

另请参阅:

• DefaultCacheAwareContextLoaderDelegate(ContextCache)

DefaultCacheAwareContextLoaderDelegate

public DefaultCacheAwareContextLoaderDelegate(ContextCache contextCache)

Construct a new DefaultCacheAwareContextLoaderDelegate using the supplied ContextCache and the default or user-configured context failure threshold.

另请参阅:

• DefaultCacheAwareContextLoaderDelegate()
• ContextCacheUtils.retrieveContextFailureThreshold()

DefaultCacheAwareContextLoaderDelegate

private DefaultCacheAwareContextLoaderDelegate(ContextCache contextCache,
 int failureThreshold)

Construct a new DefaultCacheAwareContextLoaderDelegate using the supplied ContextCache and context failure threshold.

方法详细资料

isContextLoaded

public boolean isContextLoaded(MergedContextConfiguration mergedConfig)

从接口复制的说明: CacheAwareContextLoaderDelegate

Determine if the application context for the supplied MergedContextConfiguration has been loaded (i.e., is present in the ContextCache).

Implementations of this method must not load the application context as a side effect. In addition, implementations of this method should not log the cache statistics via ContextCache.logStatistics().

The default implementation of this method always returns false. Custom CacheAwareContextLoaderDelegate implementations are therefore highly encouraged to override this method with a more meaningful implementation. Note that the standard CacheAwareContextLoaderDelegate implementation in Infra overrides this method appropriately.

指定者:

isContextLoaded 在接口中 CacheAwareContextLoaderDelegate

参数:

mergedConfig - the merged context configuration used to load the application context; never null

返回:

true if the application context has been loaded

另请参阅:

• CacheAwareContextLoaderDelegate.loadContext(cn.taketoday.test.context.MergedContextConfiguration)
• CacheAwareContextLoaderDelegate.closeContext(cn.taketoday.test.context.MergedContextConfiguration, cn.taketoday.test.annotation.DirtiesContext.HierarchyMode)

loadContext

public cn.taketoday.context.ApplicationContext loadContext(MergedContextConfiguration mergedConfig)

从接口复制的说明: CacheAwareContextLoaderDelegate

Load the application context for the supplied MergedContextConfiguration by delegating to the ContextLoader configured in the given MergedContextConfiguration.

If the context is present in the ContextCache it will simply be returned; otherwise, it will be loaded, stored in the cache, and returned.

Implementations of this method should load ApplicationContextFailureProcessor implementations via the TodayStrategies mechanism, catch any exception thrown by the ContextLoader, and delegate to each of the configured failure processors to process the context load failure if the exception is an instance of ContextLoadException.

Implementations of this method are encouraged to support the failure threshold feature. Specifically, if repeated attempts are made to load an application context and that application context consistently fails to load — for example, due to a configuration error that prevents the context from successfully loading — this method should preemptively throw an IllegalStateException if the configured failure threshold has been exceeded. Note that the ContextCache provides support for tracking and incrementing the failure count for a given context cache key.

The cache statistics should be logged by invoking ContextCache.logStatistics().

指定者:

loadContext 在接口中 CacheAwareContextLoaderDelegate

参数:

mergedConfig - the merged context configuration to use to load the application context; never null

返回:

the application context (never null)

另请参阅:

• CacheAwareContextLoaderDelegate.isContextLoaded(cn.taketoday.test.context.MergedContextConfiguration)
• CacheAwareContextLoaderDelegate.closeContext(cn.taketoday.test.context.MergedContextConfiguration, cn.taketoday.test.annotation.DirtiesContext.HierarchyMode)

closeContext

public void closeContext(MergedContextConfiguration mergedConfig,
 @Nullable
 DirtiesContext.HierarchyMode hierarchyMode)

从接口复制的说明: CacheAwareContextLoaderDelegate

Remove the application context for the supplied MergedContextConfiguration from the ContextCache and close it if it is an instance of ConfigurableApplicationContext.

The semantics of the supplied HierarchyMode must be honored when removing the context from the cache. See the Javadoc for DirtiesContext.HierarchyMode for details.

Generally speaking, this method should only be called if the state of a singleton bean has been changed (potentially affecting future interaction with the context) or if the context needs to be prematurely removed from the cache.

指定者:

closeContext 在接口中 CacheAwareContextLoaderDelegate

参数:

mergedConfig - the merged context configuration for the application context to close; never null

hierarchyMode - the hierarchy mode; may be null if the context is not part of a hierarchy

另请参阅:

• CacheAwareContextLoaderDelegate.isContextLoaded(cn.taketoday.test.context.MergedContextConfiguration)
• CacheAwareContextLoaderDelegate.loadContext(cn.taketoday.test.context.MergedContextConfiguration)

getContextCache

protected ContextCache getContextCache()

Get the ContextCache used by this context loader delegate.

loadContextInternal

protected cn.taketoday.context.ApplicationContext loadContextInternal(MergedContextConfiguration mergedConfig)
                                                               throws Exception

Load the ApplicationContext for the supplied merged context configuration.

Supports both the SmartContextLoader and ContextLoader SPIs.

抛出:

Exception - if an error occurs while loading the application context

loadContextInAotMode

protected cn.taketoday.context.ApplicationContext loadContextInAotMode(AotMergedContextConfiguration aotMergedConfig)
                                                                throws Exception

抛出:

Exception

getContextLoader

private ContextLoader getContextLoader(MergedContextConfiguration mergedConfig)

replaceIfNecessary

private MergedContextConfiguration replaceIfNecessary(MergedContextConfiguration mergedConfig)

If the test class associated with the supplied MergedContextConfiguration has an AOT-optimized ApplicationContext, this method will create an AotMergedContextConfiguration to replace the provided MergedContextConfiguration.

Otherwise, this method simply returns the supplied MergedContextConfiguration unmodified.

This allows for transparent ContextCache support for AOT-optimized application contexts.

参数:

mergedConfig - the original MergedContextConfiguration

返回:

AotMergedContextConfiguration or the original MergedContextConfiguration

抛出:

IllegalStateException - if running in AOT mode and the test class does not have an AOT-optimized ApplicationContext