|
Oracle® Coherence Java API Reference Release 3.7.1.0 E22843-01 |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object
com.tangosol.net.WrapperService
com.tangosol.net.WrapperCacheService
public class WrapperCacheService
CacheService implementation that delegates to a wrapped CacheService instance.
Nested Class Summary |
---|
Nested classes/interfaces inherited from interface com.tangosol.net.CacheService |
---|
CacheService.CacheAction |
Field Summary |
---|
Fields inherited from class com.tangosol.net.WrapperService |
---|
m_service |
Fields inherited from interface com.tangosol.net.CacheService |
---|
TYPE_DISTRIBUTED, TYPE_LOCAL, TYPE_OPTIMISTIC, TYPE_REMOTE, TYPE_REPLICATED |
Constructor Summary | |
---|---|
WrapperCacheService(CacheService service) Create a new WrapperCacheService that delegates to the given CacheService instance. |
Method Summary | |
---|---|
void |
destroyCache(NamedCache map) Release and destroy the specified cache. |
NamedCache |
ensureCache(java.lang.String sName, java.lang.ClassLoader loader) Obtain a NamedCache interface that provides a view of resources shared among members of a cluster. |
BackingMapManager |
getBackingMapManager() Return a backing map manager used by this CacheService. |
java.util.Enumeration |
getCacheNames() Returns an Enumeration of String objects, one for each cache name that has been previously registered with this CacheService. |
CacheService |
getCacheService() Return the wrapped CacheService. |
void |
releaseCache(NamedCache map) Release local resources associated with the specified instance of the cache. |
void |
setBackingMapManager(BackingMapManager manager) Set a backing map manager to be used by this CacheService to create underlying stores for the cached data. |
java.lang.String |
toString() |
Methods inherited from class com.tangosol.net.WrapperService |
---|
addMemberListener, addServiceListener, configure, getCluster, getContextClassLoader, getInfo, getSerializer, getService, getUserContext, isRunning, removeMemberListener, removeServiceListener, setContextClassLoader, setUserContext, shutdown, start, stop |
Methods inherited from interface com.tangosol.net.Service |
---|
addMemberListener, getCluster, getInfo, getSerializer, getUserContext, removeMemberListener, setUserContext |
Methods inherited from interface com.tangosol.util.Service |
---|
addServiceListener, removeServiceListener |
Methods inherited from interface com.tangosol.util.Controllable |
---|
configure, isRunning, shutdown, start, stop |
Methods inherited from interface com.tangosol.io.ClassLoaderAware |
---|
getContextClassLoader, setContextClassLoader |
Constructor Detail |
---|
public WrapperCacheService(CacheService service)
service
- the CacheService to wrapMethod Detail |
---|
public BackingMapManager getBackingMapManager()
getBackingMapManager
in interface CacheService
CacheService.setBackingMapManager(BackingMapManager)
public void setBackingMapManager(BackingMapManager manager)
setBackingMapManager
in interface CacheService
manager
- a backing map managerpublic NamedCache ensureCache(java.lang.String sName, java.lang.ClassLoader loader)
ensureCache
in interface CacheService
sName
- the name, within this CacheService, that uniquely identifies a view; null is legal, and may imply a default nameloader
- ClassLoader that should be used to deserialize objects inserted in the map by other members of the cluster; null is legal, and implies the default ClassLoader, which will typically be the context ClassLoader for this servicepublic java.util.Enumeration getCacheNames()
getCacheNames
in interface CacheService
public void releaseCache(NamedCache map)
CacheService.ensureCache(String, ClassLoader)
method.
Releasing a Map reference to a cache makes the Map reference no longer usable, but does not affect the cache itself. In other words, all other references to the cache will still be valid, and the cache data is not affected by releasing the reference.
The reference that is released using this method can no longer be used; any attempt to use the reference will result in an exception.
The purpose for releasing a cache reference is to allow the cache implementation to release the ClassLoader used to deserialize items in the cache. The cache implementation ensures that all references to that ClassLoader are released. This implies that objects in the cache that were loaded by that ClassLoader will be re-serialized to release their hold on that ClassLoader. The result is that the ClassLoader can be garbage-collected by Java in situations where the cache is operating in an application server and applications are dynamically loaded and unloaded.
releaseCache
in interface CacheService
map
- the cache object to be releasedNamedCache.release()
public void destroyCache(NamedCache map)
Warning: This method is used to completely destroy the specified cache across the cluster. All references in the entire cluster to this cache will be invalidated, the cached data will be cleared, and all resources will be released.
destroyCache
in interface CacheService
map
- the cache object to be releasedNamedCache.destroy()
public java.lang.String toString()
toString
in class WrapperService
public CacheService getCacheService()
|
Oracle® Coherence Java API Reference Release 3.7.1.0 E22843-01 |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |