org.springframework.test.context.cache

Class DefaultContextCache

java.lang.Object

org.springframework.test.context.cache.DefaultContextCache

All Implemented Interfaces:

ContextCache

public class DefaultContextCache
extends java.lang.Object
implements ContextCache

Default implementation of the ContextCache API.

Uses ConcurrentHashMaps to cache ApplicationContext and MergedContextConfiguration instances.

Since:

2.5

Author:

Sam Brannen, Juergen Hoeller

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.Map<MergedContextConfiguration,ApplicationContext>	contextMap Map of context keys to Spring ApplicationContext instances.
private java.util.Map<MergedContextConfiguration,java.util.Set<MergedContextConfiguration>>	hierarchyMap Map of parent keys to sets of children keys, representing a top-down tree of context hierarchies.
private java.util.concurrent.atomic.AtomicInteger	hitCount
private java.util.concurrent.atomic.AtomicInteger	missCount
private static Log	statsLogger

Fields inherited from interface org.springframework.test.context.cache.ContextCache

CONTEXT_CACHE_LOGGING_CATEGORY

Constructor Summary

Constructors

Constructor and Description
DefaultContextCache()

Method Summary

Modifier and Type	Method and Description
void	clear() Clear all contexts from the cache, clearing context hierarchy information as well.
void	clearStatistics() Clear hit and miss count statistics for the cache (i.e., reset counters to zero).
boolean	contains(MergedContextConfiguration key) Determine whether there is a cached context for the given key.
ApplicationContext	get(MergedContextConfiguration key) Obtain a cached ApplicationContext for the given key.
int	getHitCount() Get the overall hit count for this cache.
int	getMissCount() Get the overall miss count for this cache.
int	getParentContextCount() Determine the number of parent contexts currently tracked within the cache.
void	logStatistics() Log the statistics for this ContextCache at DEBUG level using the "org.springframework.test.context.cache" logging category.
void	put(MergedContextConfiguration key, ApplicationContext context) Explicitly add an ApplicationContext instance to the cache under the given key.
private void	remove(java.util.List<MergedContextConfiguration> removedContexts, MergedContextConfiguration key)
void	remove(MergedContextConfiguration key, DirtiesContext.HierarchyMode hierarchyMode) Remove the context with the given key from the cache and explicitly close it if it is an instance of ConfigurableApplicationContext.
void	reset() Reset all state maintained by this cache including statistics.
int	size() Determine the number of contexts currently stored in the cache.
java.lang.String	toString() Generate a text string containing the implementation type of this cache and its statistics.

Methods inherited from class java.lang.Object

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

Field Detail

statsLogger

private static final Log statsLogger

contextMap

private final java.util.Map<MergedContextConfiguration,ApplicationContext> contextMap

Map of context keys to Spring ApplicationContext instances.

hierarchyMap

private final java.util.Map<MergedContextConfiguration,java.util.Set<MergedContextConfiguration>> hierarchyMap

Map of parent keys to sets of children keys, representing a top-down tree of context hierarchies. This information is used for determining which subtrees need to be recursively removed and closed when removing a context that is a parent of other contexts.

hitCount

private final java.util.concurrent.atomic.AtomicInteger hitCount

missCount

private final java.util.concurrent.atomic.AtomicInteger missCount

Constructor Detail

DefaultContextCache

public DefaultContextCache()

Method Detail

contains

public boolean contains(MergedContextConfiguration key)

Determine whether there is a cached context for the given key.

Specified by:

contains in interface ContextCache

Parameters:

key - the context key (never null)

Returns:

true if the cache contains a context with the given key

get

public ApplicationContext get(MergedContextConfiguration key)

Obtain a cached ApplicationContext for the given key.

The hit and miss counts must be updated accordingly.

Specified by:

get in interface ContextCache

Parameters:

key - the context key (never null)

Returns:

the corresponding ApplicationContext instance, or null if not found in the cache

See Also:

ContextCache.remove(org.springframework.test.context.MergedContextConfiguration, org.springframework.test.annotation.DirtiesContext.HierarchyMode)

put

public void put(MergedContextConfiguration key,
                ApplicationContext context)

Explicitly add an ApplicationContext instance to the cache under the given key.

Specified by:

put in interface ContextCache

Parameters:

key - the context key (never null)

context - the ApplicationContext instance (never null)

remove

public void remove(MergedContextConfiguration key,
                   DirtiesContext.HierarchyMode hierarchyMode)

Remove the context with the given key from the cache and explicitly close it if it is an instance of ConfigurableApplicationContext.

Generally speaking, this method should be called if the state of a singleton bean has been modified, potentially affecting future interaction with the context.

In addition, the semantics of the supplied HierarchyMode must be honored. See the Javadoc for DirtiesContext.HierarchyMode for details.

Specified by:

remove in interface ContextCache

Parameters:

key - the context key; never null

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

remove

private void remove(java.util.List<MergedContextConfiguration> removedContexts,
                    MergedContextConfiguration key)

size

public int size()

Determine the number of contexts currently stored in the cache.

If the cache contains more than Integer.MAX_VALUE elements, this method must return Integer.MAX_VALUE.

Specified by:

size in interface ContextCache

getParentContextCount

public int getParentContextCount()

Determine the number of parent contexts currently tracked within the cache.

Specified by:

getParentContextCount in interface ContextCache

getHitCount

public int getHitCount()

Get the overall hit count for this cache.

A hit is any access to the cache that returns a non-null context for the queried key.

Specified by:

getHitCount in interface ContextCache

getMissCount

public int getMissCount()

Get the overall miss count for this cache.

A miss is any access to the cache that returns a null context for the queried key.

Specified by:

getMissCount in interface ContextCache

reset

public void reset()

Reset all state maintained by this cache including statistics.

Specified by:

reset in interface ContextCache

See Also:

ContextCache.clear(), ContextCache.clearStatistics()

clear

public void clear()

Clear all contexts from the cache, clearing context hierarchy information as well.

Specified by:

clear in interface ContextCache

clearStatistics

public void clearStatistics()

Clear hit and miss count statistics for the cache (i.e., reset counters to zero).

Specified by:

clearStatistics in interface ContextCache

logStatistics

public void logStatistics()

Log the statistics for this ContextCache at DEBUG level using the "org.springframework.test.context.cache" logging category.

The following information should be logged.

• name of the concrete ContextCache implementation
• ContextCache.size()
• parent context count
• hit count
• miss count
• any other information useful for monitoring the state of this cache

Specified by:

logStatistics in interface ContextCache

toString

public java.lang.String toString()

Generate a text string containing the implementation type of this cache and its statistics.

The string returned by this method contains all information required for compliance with the contract for logStatistics().

Overrides:

toString in class java.lang.Object

Returns:

a string representation of this cache, including statistics