org.springframework.test.context

Interface CacheAwareContextLoaderDelegate

All Known Implementing Classes:

DefaultCacheAwareContextLoaderDelegate

public interface CacheAwareContextLoaderDelegate

A CacheAwareContextLoaderDelegate is responsible for loading and closing application contexts, interacting transparently with a ContextCache behind the scenes.

Note: CacheAwareContextLoaderDelegate does not extend the ContextLoader or SmartContextLoader interface.

Since:

3.2.2

Author:

Sam Brannen

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_CACHE_AWARE_CONTEXT_LOADER_DELEGATE_PROPERTY_NAME System property used to configure the fully qualified class name of the default CacheAwareContextLoaderDelegate.

Method Summary

Modifier and Type	Method and Description
void	closeContext(MergedContextConfiguration mergedContextConfiguration, DirtiesContext.HierarchyMode hierarchyMode) Remove the application context for the supplied MergedContextConfiguration from the ContextCache and close it if it is an instance of ConfigurableApplicationContext.
default boolean	isContextLoaded(MergedContextConfiguration mergedContextConfiguration) Determine if the application context for the supplied MergedContextConfiguration has been loaded (i.e., is present in the ContextCache).
ApplicationContext	loadContext(MergedContextConfiguration mergedContextConfiguration) Load the application context for the supplied MergedContextConfiguration by delegating to the ContextLoader configured in the given MergedContextConfiguration.

Field Detail

DEFAULT_CACHE_AWARE_CONTEXT_LOADER_DELEGATE_PROPERTY_NAME

static final String DEFAULT_CACHE_AWARE_CONTEXT_LOADER_DELEGATE_PROPERTY_NAME

System property used to configure the fully qualified class name of the default CacheAwareContextLoaderDelegate.

May alternatively be configured via the SpringProperties mechanism.

If this property is not defined, the DefaultCacheAwareContextLoaderDelegate will be used as the default.

Since:

5.3.11

See Also:

Constant Field Values

Method Detail

isContextLoaded

default boolean isContextLoaded(MergedContextConfiguration mergedContextConfiguration)

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 Spring overrides this method appropriately.

Parameters:

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

Returns:

true if the application context has been loaded

Since:

5.2

See Also:

loadContext(org.springframework.test.context.MergedContextConfiguration), closeContext(org.springframework.test.context.MergedContextConfiguration, org.springframework.test.annotation.DirtiesContext.HierarchyMode)

loadContext

ApplicationContext loadContext(MergedContextConfiguration mergedContextConfiguration)

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.

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

Parameters:

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

Returns:

the application context (never null)

Throws:

IllegalStateException - if an error occurs while retrieving or loading the application context

See Also:

isContextLoaded(org.springframework.test.context.MergedContextConfiguration), closeContext(org.springframework.test.context.MergedContextConfiguration, org.springframework.test.annotation.DirtiesContext.HierarchyMode)

closeContext

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

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.

Parameters:

mergedContextConfiguration - 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

Since:

4.1

See Also:

isContextLoaded(org.springframework.test.context.MergedContextConfiguration), loadContext(org.springframework.test.context.MergedContextConfiguration)