|
CoherenceTM v3.3 Copyright© 2000-2007 by Oracle Corporation |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.util.AbstractMap
com.tangosol.net.cache.ReadWriteBackingMap
com.tangosol.net.cache.VersionedBackingMap
public class VersionedBackingMap
Backing Map implementation that provides a size-limited cache of a persistent store and supports configurable write-behind caching. Additionally, this implementation supports a VersionedNearCache in front of the distributed cache, and manages version data caches to optimize the near cache without sacrificing data integrity.
This implementation does not support null keys or null values. The values stored in this Map must implement the Versionable interface.
Nested Class Summary | |
---|---|
class |
VersionedBackingMap.CacheStoreWrapper
Deprecated. A wrapper around the original CacheStore to allow operations to be overridden and extended. |
protected class |
VersionedBackingMap.InternalMapListener
Deprecated. A MapListener implementation that listens to the internal cache and routes those events to anyone listening to this VersionedBackingMap. |
Nested classes/interfaces inherited from class com.tangosol.net.cache.ReadWriteBackingMap |
---|
ReadWriteBackingMap.CacheLoaderCacheStore, ReadWriteBackingMap.EntrySet, ReadWriteBackingMap.KeySet, ReadWriteBackingMap.ReadLatch, ReadWriteBackingMap.ReadQueue, ReadWriteBackingMap.ReadThread, ReadWriteBackingMap.ValuesCollection, ReadWriteBackingMap.WriteQueue, ReadWriteBackingMap.WriteThread |
Nested classes/interfaces inherited from interface java.util.Map |
---|
Map.Entry |
Field Summary | |
---|---|
static long |
MAX_LOCK_WAIT
Deprecated. The length of time (in millis) to wait on a lock; keep this value low to avoid causing timing problems since some calls will be on the distributed cache thread. |
Fields inherited from class com.tangosol.net.cache.ReadWriteBackingMap |
---|
m_listenerSupport, NO_VALUE |
Constructor Summary | |
---|---|
VersionedBackingMap(BackingMapManagerContext ctxService,
ObservableMap mapInternal,
Map mapMisses,
CacheLoader loader,
NamedCache mapVersionTransient,
NamedCache mapVersionPersist,
boolean fManageTransient)
Deprecated. Construct a VersionedBackingMap using a CacheLoader object. |
|
VersionedBackingMap(BackingMapManagerContext ctxService,
ObservableMap mapInternal,
Map mapMisses,
CacheStore store,
boolean fReadOnly,
int cWriteBehindSeconds,
double dflRefreshAheadFactor,
NamedCache mapVersionTransient,
NamedCache mapVersionPersist,
boolean fManageTransient)
Deprecated. Construct a VersionedBackingMap using a CacheStore object. |
|
VersionedBackingMap(BackingMapManagerContext ctxService,
ObservableMap mapInternal,
Map mapMisses,
CacheStore store,
boolean fReadOnly,
int cWriteBehindSeconds,
NamedCache mapVersionTransient,
NamedCache mapVersionPersist,
boolean fManageTransient)
Deprecated. Construct a VersionedBackingMap using a CacheStore object. |
Method Summary | |
---|---|
NamedCache |
getPersistentVersionCache()
Deprecated. Get the cache of version info for the data stored in the persistent store behind this backing map (and other related backing maps if this is backing a distributed cache). |
NamedCache |
getTransientVersionCache()
Deprecated. Get the cache of version info for the data maintained in this backing map (and other related backing maps if this is backing a distributed cache). |
protected ReadWriteBackingMap.CacheStoreWrapper |
instantiateCacheStoreWrapper(CacheStore store)
Deprecated. Factory pattern: Instantiate a CacheStore wrapper around the passed CacheStore. |
protected MapListener |
instantiateInternalListener()
Deprecated. Factory pattern: Create a MapListener that listens to the internal cache and routes those events to anyone listening to this VersionedBackingMap. |
boolean |
isManagingTransientVersion()
Deprecated. Determine if this backing map is responsible for keeping the transient version cache in sync. |
protected void |
updatePersistentVersion(Object oKey,
Comparable ver)
Deprecated. Update the persistent version of the specified key. |
protected void |
updateTransientVersion(Object oKey,
Comparable ver)
Deprecated. Update the transient version of the specified key. |
Methods inherited from class java.util.AbstractMap |
---|
clone, isEmpty, putAll |
Methods inherited from interface java.util.Map |
---|
isEmpty, putAll |
Field Detail |
---|
public static final long MAX_LOCK_WAIT
Constructor Detail |
---|
public VersionedBackingMap(BackingMapManagerContext ctxService, ObservableMap mapInternal, Map mapMisses, CacheLoader loader, NamedCache mapVersionTransient, NamedCache mapVersionPersist, boolean fManageTransient)
ctxService
- the context provided by the CacheService
which is using this backing mapmapInternal
- the ObservableMap used to store the data
internally in this backing mapmapMisses
- the Map used to cache CacheLoader misses
(optional)loader
- the object responsible for loading the
cached data (optional)mapVersionTransient
- (optional) a replicated cache of versions
of the cached data as it is in memorymapVersionPersist
- (optional) a replicated cache of versions
of the cached data as it was written to the
CacheStorefManageTransient
- if true, the backing map is responsible for
keeping the transient version cache up to
date; if false (as is the case when using
the VersionedNearCache implementation), the
backing map manages the transient version
cache only for operations for which no
other party is aware (such as entry expiry)public VersionedBackingMap(BackingMapManagerContext ctxService, ObservableMap mapInternal, Map mapMisses, CacheStore store, boolean fReadOnly, int cWriteBehindSeconds, NamedCache mapVersionTransient, NamedCache mapVersionPersist, boolean fManageTransient)
ctxService
- the context provided by the CacheService
which is using this backing mapmapInternal
- the ObservableMap used to store the data
internally in this backing mapmapMisses
- the Map used to cache CacheStore misses
(optional)store
- the object responsible for the persistence
of the cached data (optional)fReadOnly
- pass true to use the CacheStore only for
read operationscWriteBehindSeconds
- number of seconds to write if there is a
CacheStore; zero disables write-behind
caching (optional)mapVersionTransient
- (optional) a replicated cache of versions
of the cached data as it is in memorymapVersionPersist
- (optional) a replicated cache of versions
of the cached data as it was written to the
CacheStorefManageTransient
- if true, the backing map is responsible for
keeping the transient version cache up to
date; if false (as is the case when using
the VersionedNearCache implementation), the
backing map manages the transient version
cache only for operations for which no
other party is aware (such as entry expiry)public VersionedBackingMap(BackingMapManagerContext ctxService, ObservableMap mapInternal, Map mapMisses, CacheStore store, boolean fReadOnly, int cWriteBehindSeconds, double dflRefreshAheadFactor, NamedCache mapVersionTransient, NamedCache mapVersionPersist, boolean fManageTransient)
ctxService
- the context provided by the CacheService
which is using this backing mapmapInternal
- the ObservableMap used to store the data
internally in this backing mapmapMisses
- the Map used to cache CacheStore misses
(optional)store
- the object responsible for the persistence
of the cached data (optional)fReadOnly
- pass true to use the CacheStore only for
read operationscWriteBehindSeconds
- number of seconds to write if there is a
CacheStore; zero disables write-behind
caching (optional)dflRefreshAheadFactor
- the interval before an entry expiration time
(expressed as a percentage of the internal
cache expiration interval) during which an
asynchronous load request for the
entry will be scheduled; zero disables
refresh-ahead; only applicable when
the mapInternal parameter is an
instance of LocalCache
(optional)mapVersionTransient
- (optional) a replicated cache of versions
of the cached data as it is in memorymapVersionPersist
- (optional) a replicated cache of versions
of the cached data as it was written to the
CacheStorefManageTransient
- if true, the backing map is responsible for
keeping the transient version cache up to
date; if false (as is the case when using
the VersionedNearCache implementation), the
backing map manages the transient version
cache only for operations for which no
other party is aware (such as entry expiry)Method Detail |
---|
protected MapListener instantiateInternalListener()
instantiateInternalListener
in class ReadWriteBackingMap
protected ReadWriteBackingMap.CacheStoreWrapper instantiateCacheStoreWrapper(CacheStore store)
instantiateCacheStoreWrapper
in class ReadWriteBackingMap
store
- the CacheStore to wrap
public NamedCache getPersistentVersionCache()
protected void updatePersistentVersion(Object oKey, Comparable ver)
oKey
- the key in its external ("real") formatver
- the new version to store; null implies removepublic NamedCache getTransientVersionCache()
protected void updateTransientVersion(Object oKey, Comparable ver)
oKey
- the key in its external ("real") formatver
- the new version to store; null implies removepublic boolean isManagingTransientVersion()
|
CoherenceTM v3.3 Copyright© 2000-2007 by Oracle Corporation |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |