org.springframework.cache.jcache

Class JCacheCacheManager

java.lang.Object

org.springframework.cache.support.AbstractCacheManager

org.springframework.cache.transaction.AbstractTransactionSupportingCacheManager

org.springframework.cache.jcache.JCacheCacheManager

All Implemented Interfaces:

InitializingBean, CacheManager

public class JCacheCacheManager
extends AbstractTransactionSupportingCacheManager

CacheManager implementation backed by a JCache CacheManager.

Note: This class has been updated for JCache 1.0, as of Spring 4.0.

Since:

3.2

Author:

Juergen Hoeller, Stephane Nicoll

Constructor Summary

Constructors

Constructor and Description
JCacheCacheManager() Create a new JCacheCacheManager, setting the target JCache CacheManager through the setCacheManager(javax.cache.CacheManager) bean property.
JCacheCacheManager(javax.cache.CacheManager cacheManager) Create a new JCacheCacheManager for the given backing JCache.

Method Summary

Modifier and Type	Method and Description
void	afterPropertiesSet() Invoked by the containing BeanFactory after it has set all bean properties and satisfied BeanFactoryAware, ApplicationContextAware etc.
javax.cache.CacheManager	getCacheManager() Return the backing JCache CacheManager.
protected Cache	getMissingCache(String name) Return a missing cache with the specified name, or null if such a cache does not exist or could not be created on demand.
boolean	isAllowNullValues() Return whether this cache manager accepts and converts null values for all of its caches.
protected Collection<Cache>	loadCaches() Load the initial caches for this cache manager.
void	setAllowNullValues(boolean allowNullValues) Specify whether to accept and convert null values for all caches in this cache manager.
void	setCacheManager(javax.cache.CacheManager cacheManager) Set the backing JCache CacheManager.

Methods inherited from class org.springframework.cache.transaction.AbstractTransactionSupportingCacheManager

decorateCache, isTransactionAware, setTransactionAware

Methods inherited from class org.springframework.cache.support.AbstractCacheManager

addCache, getCache, getCacheNames, initializeCaches, lookupCache

Methods inherited from class java.lang.Object

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

Constructor Detail

JCacheCacheManager

public JCacheCacheManager()

Create a new JCacheCacheManager, setting the target JCache CacheManager through the setCacheManager(javax.cache.CacheManager) bean property.

JCacheCacheManager

public JCacheCacheManager(javax.cache.CacheManager cacheManager)

Create a new JCacheCacheManager for the given backing JCache.

Parameters:

cacheManager - the backing JCache CacheManager

Method Detail

setCacheManager

public void setCacheManager(@Nullable
                            javax.cache.CacheManager cacheManager)

Set the backing JCache CacheManager.

getCacheManager

@Nullable
public javax.cache.CacheManager getCacheManager()

Return the backing JCache CacheManager.

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 JSR-107 itself not supporting null values. An internal holder object will be used to store user-level nulls.

isAllowNullValues

public boolean isAllowNullValues()

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

afterPropertiesSet

public void afterPropertiesSet()

Description copied from interface: InitializingBean

Invoked by the containing BeanFactory after it has set all bean properties and satisfied BeanFactoryAware, ApplicationContextAware etc.

This method allows the bean instance to perform validation of its overall configuration and final initialization when all bean properties have been set.

Specified by:

afterPropertiesSet in interface InitializingBean

Overrides:

afterPropertiesSet in class AbstractCacheManager

loadCaches

protected Collection<Cache> loadCaches()

Description copied from class: AbstractCacheManager

Load the initial caches for this cache manager.

Called by AbstractCacheManager.afterPropertiesSet() on startup. The returned collection may be empty but must not be null.

Specified by:

loadCaches in class AbstractCacheManager

getMissingCache

protected Cache getMissingCache(String name)

Description copied from class: AbstractCacheManager

Return a missing cache with the specified name, or null if such a cache does not exist or could not be created on demand.

Caches may be lazily created at runtime if the native provider supports it. If a lookup by name does not yield any result, an AbstractCacheManager subclass gets a chance to register such a cache at runtime. The returned cache will be automatically added to this cache manager.

Overrides:

getMissingCache in class AbstractCacheManager

Parameters:

name - the name of the cache to retrieve

Returns:

the missing cache, or null if no such cache exists or could be created on demand

See Also:

AbstractCacheManager.getCache(String)