Package org.springframework.test.context
Interface CacheAwareContextLoaderDelegate
- All Known Implementing Classes:
DefaultCacheAwareContextLoaderDelegate
public interface CacheAwareContextLoaderDelegate
ACacheAwareContextLoaderDelegate
is responsible for loading and closing application contexts, interacting transparently with aContextCache
behind the scenes.Note:
CacheAwareContextLoaderDelegate
does not extend theContextLoader
orSmartContextLoader
interface.- Since:
- 3.2.2
- Author:
- Sam Brannen
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description void
closeContext(MergedContextConfiguration mergedContextConfiguration, DirtiesContext.HierarchyMode hierarchyMode)
Remove the application context for the suppliedMergedContextConfiguration
from theContextCache
and close it if it is an instance ofConfigurableApplicationContext
.ApplicationContext
loadContext(MergedContextConfiguration mergedContextConfiguration)
Load the application context for the suppliedMergedContextConfiguration
by delegating to theContextLoader
configured in the givenMergedContextConfiguration
.
Method Detail
loadContext
ApplicationContext loadContext(MergedContextConfiguration mergedContextConfiguration)
Load the application context for the suppliedMergedContextConfiguration
by delegating to theContextLoader
configured in the givenMergedContextConfiguration
.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; nevernull
- Returns:
- the application context
- Throws:
IllegalStateException
- if an error occurs while retrieving or loading the application context
closeContext
void closeContext(MergedContextConfiguration mergedContextConfiguration, DirtiesContext.HierarchyMode hierarchyMode)
Remove the application context for the suppliedMergedContextConfiguration
from theContextCache
and close it if it is an instance ofConfigurableApplicationContext
.The semantics of the supplied
HierarchyMode
must be honored when removing the context from the cache. See the Javadoc forDirtiesContext.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; nevernull
hierarchyMode
- the hierarchy mode; may benull
if the context is not part of a hierarchy- Since:
- 4.1