org.springframework.cache.concurrent

Class ConcurrentMapCacheManager

java.lang.Object

org.springframework.cache.concurrent.ConcurrentMapCacheManager

All Implemented Interfaces:

CacheManager

public class ConcurrentMapCacheManager
extends Object
implements CacheManager

CacheManager implementation that lazily builds ConcurrentMapCache instances for each getCache(java.lang.String) request. Also supports a 'static' mode where the set of cache names is pre-defined through setCacheNames(java.util.Collection<java.lang.String>), with no dynamic creation of further cache regions at runtime.

Note: This is by no means a sophisticated CacheManager; it comes with no cache configuration options. However, it may be useful for testing or simple caching scenarios. For advanced local caching needs, consider GuavaCacheManager or EhCacheCacheManager.

Since:

3.1

Author:

Juergen Hoeller

See Also:

ConcurrentMapCache

Constructor Summary

Constructors

Constructor and Description
ConcurrentMapCacheManager() Construct a dynamic ConcurrentMapCacheManager, lazily creating cache instances as they are being requested.
ConcurrentMapCacheManager(String... cacheNames) Construct a static ConcurrentMapCacheManager, managing caches for the specified cache names only.

Method Summary

Modifier and Type	Method and Description
protected Cache	createConcurrentMapCache(String name) Create a new ConcurrentMapCache instance for the specified cache name.
Cache	getCache(String name) Return the cache associated with the given name.
Collection<String>	getCacheNames() Return a collection of the cache names known by this manager.
boolean	isAllowNullValues() Return whether this cache manager accepts and converts null values for all of its caches.
void	setAllowNullValues(boolean allowNullValues) Specify whether to accept and convert null values for all caches in this cache manager.
void	setCacheNames(Collection<String> cacheNames) Specify the set of cache names for this CacheManager's 'static' mode.

Methods inherited from class java.lang.Object

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

Constructor Detail

ConcurrentMapCacheManager

public ConcurrentMapCacheManager()

Construct a dynamic ConcurrentMapCacheManager, lazily creating cache instances as they are being requested.

ConcurrentMapCacheManager

public ConcurrentMapCacheManager(String... cacheNames)

Construct a static ConcurrentMapCacheManager, managing caches for the specified cache names only.

Method Detail

setCacheNames

public void setCacheNames(Collection<String> cacheNames)

Specify the set of cache names for this CacheManager's 'static' mode.

The number of caches and their names will be fixed after a call to this method, with no creation of further cache regions at runtime.

Calling this with a null collection argument resets the mode to 'dynamic', allowing for further creation of caches again.

setAllowNullValues

public void setAllowNullValues(boolean allowNullValues)

Specify whether to accept and convert null values for all caches in this cache manager.

Default is "true", despite ConcurrentHashMap itself not supporting null values. An internal holder object will be used to store user-level nulls.

Note: A change of the null-value setting will reset all existing caches, if any, to reconfigure them with the new null-value requirement.

isAllowNullValues

public boolean isAllowNullValues()

Return whether this cache manager accepts and converts null values for all of its caches.

getCacheNames

public Collection<String> getCacheNames()

Description copied from interface: CacheManager

Return a collection of the cache names known by this manager.

Specified by:

getCacheNames in interface CacheManager

Returns:

the names of all caches known by the cache manager

getCache

public Cache getCache(String name)

Description copied from interface: CacheManager

Return the cache associated with the given name.

Specified by:

getCache in interface CacheManager

Parameters:

name - the cache identifier (must not be null)

Returns:

the associated cache, or null if none found

createConcurrentMapCache

protected Cache createConcurrentMapCache(String name)

Create a new ConcurrentMapCache instance for the specified cache name.

Parameters:

name - the name of the cache

Returns:

the ConcurrentMapCache (or a decorator thereof)