com.tangosol.coherence.jcache

Class CoherenceBasedCacheManager

java.lang.Object

com.tangosol.coherence.jcache.CoherenceBasedCacheManager

All Implemented Interfaces:

com.oracle.coherence.common.base.Disposable, Closeable, AutoCloseable, javax.cache.CacheManager

public class CoherenceBasedCacheManager
extends Object
implements javax.cache.CacheManager, com.oracle.coherence.common.base.Disposable

The Coherence-based implementation of a CacheManager.

Author:

jf 2013.06.18, bo 2013.12.17

Constructor Summary

Constructors

Constructor and Description
CoherenceBasedCacheManager(CoherenceBasedCachingProvider provider, ConfigurableCacheFactory ccf, URI uri, ClassLoader classLoader, Properties properties) Constructs a new CoherenceBasedCacheManager.

Method Summary

Modifier and Type	Method and Description
void	close() Default implementation invokes Disposable.dispose(), it is not recommended that this be overridden.
<K,V,C extends javax.cache.configuration.Configuration<K,V>> javax.cache.Cache<K,V>	createCache(String sJCacheName, C cfgJCache)
void	destroyCache(String sName)
void	dispose() Invoked when all resources owned by the implementer can safely be released.
void	enableManagement(String sName, boolean fEnabled)
void	enableStatistics(String sName, boolean fEnabled)
javax.cache.Cache	getCache(String sJCacheName)
<K,V> javax.cache.Cache<K,V>	getCache(String sJCacheName, Class<K> clzKey, Class<V> clzType)
Iterable<String>	getCacheNames()
CoherenceBasedCompleteConfiguration	getCacheToConfigurationMapping(JCacheIdentifier cacheId) Provide access to meta cache that maps JCache cache names to JCache configuration.
javax.cache.spi.CachingProvider	getCachingProvider()
ClassLoader	getClassLoader()
ConfigurableCacheFactory	getConfigurableCacheFactory() Get ConfigurableCacheFactory context.
Properties	getProperties()
URI	getURI()
boolean	isClosed()
void	putCacheToConfigurationMapping(JCacheIdentifier cacheId, CoherenceBasedCompleteConfiguration config) put entry with key of sName
void	releaseCache(String sName) release cache named sName
void	removeCacheToConfigurationMapping(JCacheIdentifier cacheId) remove entry with key of sName
String	toString()
<T> T	unwrap(Class<T> clz)
boolean	validate() Validate if configurations map is valid with this instance.

Methods inherited from class java.lang.Object

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

Constructor Detail

CoherenceBasedCacheManager

public CoherenceBasedCacheManager(CoherenceBasedCachingProvider provider,
                                  ConfigurableCacheFactory ccf,
                                  URI uri,
                                  ClassLoader classLoader,
                                  Properties properties)

Constructs a new CoherenceBasedCacheManager.

Parameters:

provider - the CachingProvider that owns the CacheManager

ccf - the ConfigurableCacheFactory to use for CoherenceBasedCaches

uri - the URI of the CacheManager (this must point to a valid Coherence Cache configuration file)

classLoader - the ClassLoader to use for loading Cache resources, including keys, values, loaders, writers etc

properties - the custom configuration Properties

Method Detail

getCacheToConfigurationMapping

public CoherenceBasedCompleteConfiguration getCacheToConfigurationMapping(JCacheIdentifier cacheId)

Provide access to meta cache that maps JCache cache names to JCache configuration. The mapping is a string to a JCache Configuration object.

Parameters:

cacheId - JCache unique identifier

Returns:

a named cache that maps JCache cache names to JCache configurations.

putCacheToConfigurationMapping

public void putCacheToConfigurationMapping(JCacheIdentifier cacheId,
                                           CoherenceBasedCompleteConfiguration config)

put entry with key of sName

Parameters:

cacheId - key of entry to put into _metaJCacheNameToConfig

removeCacheToConfigurationMapping

public void removeCacheToConfigurationMapping(JCacheIdentifier cacheId)

remove entry with key of sName

Parameters:

cacheId - key of entry to remove from _metaJCacheNameToConfig

getCachingProvider

public javax.cache.spi.CachingProvider getCachingProvider()

Specified by:

getCachingProvider in interface javax.cache.CacheManager

getURI

public URI getURI()

Specified by:

getURI in interface javax.cache.CacheManager

getProperties

public Properties getProperties()

Specified by:

getProperties in interface javax.cache.CacheManager

getClassLoader

public ClassLoader getClassLoader()

Specified by:

getClassLoader in interface javax.cache.CacheManager

createCache

public <K,V,C extends javax.cache.configuration.Configuration<K,V>> javax.cache.Cache<K,V> createCache(String sJCacheName,
                                                                                                       C cfgJCache)
                                                                                                throws IllegalArgumentException

Specified by:

createCache in interface javax.cache.CacheManager

Throws:

IllegalArgumentException

getCache

public <K,V> javax.cache.Cache<K,V> getCache(String sJCacheName,
                                             Class<K> clzKey,
                                             Class<V> clzType)

Specified by:

getCache in interface javax.cache.CacheManager

getCache

public javax.cache.Cache getCache(String sJCacheName)

Specified by:

getCache in interface javax.cache.CacheManager

getCacheNames

public Iterable<String> getCacheNames()

Specified by:

getCacheNames in interface javax.cache.CacheManager

destroyCache

public void destroyCache(String sName)

Specified by:

destroyCache in interface javax.cache.CacheManager

enableStatistics

public void enableStatistics(String sName,
                             boolean fEnabled)

Specified by:

enableStatistics in interface javax.cache.CacheManager

enableManagement

public void enableManagement(String sName,
                             boolean fEnabled)

Specified by:

enableManagement in interface javax.cache.CacheManager

close

public void close()

Description copied from interface: com.oracle.coherence.common.base.Disposable

Default implementation invokes Disposable.dispose(), it is not recommended that this be overridden.

Specified by:

close in interface com.oracle.coherence.common.base.Disposable

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface javax.cache.CacheManager

dispose

public void dispose()

Description copied from interface: com.oracle.coherence.common.base.Disposable

Invoked when all resources owned by the implementer can safely be released.

Once disposed of the object should no longer be considered to be usable.

Note the Disposable interface is compatible with try-with-resources which will automatically invoke this method.

Specified by:

dispose in interface com.oracle.coherence.common.base.Disposable

isClosed

public boolean isClosed()

Specified by:

isClosed in interface javax.cache.CacheManager

unwrap

public <T> T unwrap(Class<T> clz)

Specified by:

unwrap in interface javax.cache.CacheManager

getConfigurableCacheFactory

public ConfigurableCacheFactory getConfigurableCacheFactory()

Get ConfigurableCacheFactory context.

Returns:

ConfigurableCacheFactory

releaseCache

public void releaseCache(String sName)

release cache named sName

Parameters:

sName - JCache Adapter map to release

validate

public boolean validate()

Validate if configurations map is valid with this instance.

Returns:

true iff it is valid

toString

public String toString()

Overrides:

toString in class Object