Package org.apache.openjpa.datacache
Class DelegatingDataCache
- java.lang.Object
- 
- org.apache.openjpa.datacache.DelegatingDataCache
 
- 
 public class DelegatingDataCache extends java.lang.Object implements DataCache Delegating data cache that can also perform exception translation for use in facades. This cache allows its delegate to be null, in which case it returns default values for all operations.- Author:
- Abe White
 
- 
- 
Field Summary- 
Fields inherited from interface org.apache.openjpa.datacache.DataCacheNAME_DEFAULT
 
- 
 - 
Constructor SummaryConstructors Constructor Description DelegatingDataCache(DataCache cache)Constructor.DelegatingDataCache(DataCache cache, RuntimeExceptionTranslator trans)
 - 
Method SummaryAll Methods Instance Methods Concrete Methods Modifier and Type Method Description voidaddExpirationListener(ExpirationListener listen)Add a new expiration event listener to this cache.voidclear()Remove all data from this cache.voidclose()Free the resources used by this cache.voidcommit(java.util.Collection<DataCachePCData> additions, java.util.Collection<DataCachePCData> newUpdates, java.util.Collection<DataCachePCData> existingUpdates, java.util.Collection<java.lang.Object> deletes)Perform a batch update of the cache.booleancontains(java.lang.Object oid)Returnstrueif this cache contains data corresponding tooid; otherwise returnsfalse.java.util.BitSetcontainsAll(java.util.Collection<java.lang.Object> oids)Returns the indexes of the oids in this cache.booleanequals(java.lang.Object other)DataCachePCDataget(java.lang.Object oid)Return the cached object for the given oid.java.util.Map<java.lang.Object,DataCachePCData>getAll(java.util.List<java.lang.Object> keys)Gets objects from the caches for a given list of keys.DataCachegetDelegate()Return the direct delegate.booleangetEvictOnBulkUpdate()Returns whether the the cache needs to be updated when bulk updates as executed.DataCachegetInnermostDelegate()Return the native delegate.java.lang.StringgetName()Returns a string name that can be used by end-user-visible code to identify this cache.DataCachegetPartition(java.lang.String name, boolean create)Gets the named partition.java.util.Set<java.lang.String>getPartitionNames()Gets the name of the known partitions.CacheStatisticsgetStatistics()Returns number of read/write request and cache hit ratio data.inthashCode()voidinitialize(DataCacheManager manager)Initialize any resources associated with the givenDataCacheManager.booleanisPartitioned()Affirms if this cache maintains partitions.booleanpin(java.lang.Object oid)Pin the value stored underoidinto the cache.voidpinAll(java.lang.Class<?> cls, boolean subs)Pin all oids for the given type.java.util.BitSetpinAll(java.util.Collection<java.lang.Object> oids)Pin all oids to the cache.DataCachePCDataput(DataCachePCData value)Set the cached value for the given instance.DataCachePCDataremove(java.lang.Object oid)Remove the value stored under the given oid.voidremoveAll(java.lang.Class<?> cls, boolean subclasses)Evict all values of a specified type.java.util.BitSetremoveAll(java.util.Collection<java.lang.Object> oids)Remove the values stored under the given oids.booleanremoveExpirationListener(ExpirationListener listen)Remove an expiration event listener from this cache.voidsetName(java.lang.String name)Sets a string name to be used to identify this cache to end-user needs.protected java.lang.RuntimeExceptiontranslate(java.lang.RuntimeException re)Translate the OpenJPA exception.booleanunpin(java.lang.Object oid)Unpin the value stored underoidfrom the cache.voidunpinAll(java.lang.Class<?> cls, boolean subs)Unpin all oids associaed with the given type from the cache.java.util.BitSetunpinAll(java.util.Collection<java.lang.Object> oids)Unpin all oids from the cache.voidupdate(DataCachePCData value)Update the cached value for the given instance.voidwriteLock()Obtain a write lock on the cache.voidwriteUnlock()Release the write lock on the cache.
 
- 
- 
- 
Constructor Detail- 
DelegatingDataCachepublic DelegatingDataCache(DataCache cache) Constructor. Supply delegate.
 - 
DelegatingDataCachepublic DelegatingDataCache(DataCache cache, RuntimeExceptionTranslator trans) 
 
- 
 - 
Method Detail- 
getDelegatepublic DataCache getDelegate() Return the direct delegate.
 - 
getInnermostDelegatepublic DataCache getInnermostDelegate() Return the native delegate.
 - 
hashCodepublic int hashCode() - Overrides:
- hashCodein class- java.lang.Object
 
 - 
equalspublic boolean equals(java.lang.Object other) - Overrides:
- equalsin class- java.lang.Object
 
 - 
translateprotected java.lang.RuntimeException translate(java.lang.RuntimeException re) Translate the OpenJPA exception.
 - 
getNamepublic java.lang.String getName() Description copied from interface:DataCacheReturns a string name that can be used by end-user-visible code to identify this cache.
 - 
setNamepublic void setName(java.lang.String name) Description copied from interface:DataCacheSets a string name to be used to identify this cache to end-user needs.
 - 
initializepublic void initialize(DataCacheManager manager) Description copied from interface:DataCacheInitialize any resources associated with the givenDataCacheManager.- Specified by:
- initializein interface- DataCache
 
 - 
commitpublic void commit(java.util.Collection<DataCachePCData> additions, java.util.Collection<DataCachePCData> newUpdates, java.util.Collection<DataCachePCData> existingUpdates, java.util.Collection<java.lang.Object> deletes) Description copied from interface:DataCachePerform a batch update of the cache. Add allDataCachePCDataobjects inadditionsand innewUpdates, make the appropriate modifications to all DataCachePCDatas inexistingUpdates, and delete all OIDs indeletes. All changes made to cached data must be made via this method. It is this method that is responsible for performing any side-effects that should happen on meaningful cache changes. Implementations should bear in mind that thedeletescollection may contain oids that are also in theadditionsmap. This is possible because it is valid for a user to delete an object with a particular oid and then add that object in the same batch.- Specified by:
- commitin interface- DataCache
- Parameters:
- additions- A collection of- DataCachePCDataobjects. These represent data that have been newly created, and thus must be added to the cache.
- newUpdates- A collection of- DataCachePCDataobjects. These represent data that have been modified but were not originally in the cache, and thus must be added to the cache.
- existingUpdates- A collection of- DataCachePCDataobjects. These represent data that have been modified and were originally loaded from the cache. It is up to the cache implementation to decide if these values must be re-enlisted in the cache. Some caches may return live data from- DataCache.get(java.lang.Object)invocations, in which case these values need not be re-enlisted.
- deletes- A collection of object IDs that have been deleted and must therefore be dropped from the cache.
 
 - 
containspublic boolean contains(java.lang.Object oid) Description copied from interface:DataCacheReturnstrueif this cache contains data corresponding tooid; otherwise returnsfalse.
 - 
containsAllpublic java.util.BitSet containsAll(java.util.Collection<java.lang.Object> oids) Description copied from interface:DataCacheReturns the indexes of the oids in this cache.- Specified by:
- containsAllin interface- DataCache
 
 - 
getpublic DataCachePCData get(java.lang.Object oid) Description copied from interface:DataCacheReturn the cached object for the given oid. Modifying the returned object may or may not change the cached value; theDataCache.update(org.apache.openjpa.datacache.DataCachePCData)method should be used to re-cache any changed objects.
 - 
putpublic DataCachePCData put(DataCachePCData value) Description copied from interface:DataCacheSet the cached value for the given instance. This does not result in an update of other caches. Rather, it should only be used for loading clean data into the cache. Meaningful changes to the state of the cache should be made via theDataCache.commit(java.util.Collection<org.apache.openjpa.datacache.DataCachePCData>, java.util.Collection<org.apache.openjpa.datacache.DataCachePCData>, java.util.Collection<org.apache.openjpa.datacache.DataCachePCData>, java.util.Collection<java.lang.Object>)method.
 - 
updatepublic void update(DataCachePCData value) Description copied from interface:DataCacheUpdate the cached value for the given instance. This does not result in an update of other caches. Rather, it should only be used for loading clean data into the cache. Meaningful changes to the state of the cache should be made via theDataCache.commit(java.util.Collection<org.apache.openjpa.datacache.DataCachePCData>, java.util.Collection<org.apache.openjpa.datacache.DataCachePCData>, java.util.Collection<org.apache.openjpa.datacache.DataCachePCData>, java.util.Collection<java.lang.Object>)method. A cache implementation may or may not return a live object fromDataCache.get(java.lang.Object)invocations. If an object retrieved from aDataCache.get(java.lang.Object)operation needs to be updated, this method can be invoked instead of invokingDataCache.put(org.apache.openjpa.datacache.DataCachePCData). The DataCache implementation can then make optimizations based on how itsDataCache.get(java.lang.Object)method works.
 - 
removepublic DataCachePCData remove(java.lang.Object oid) Description copied from interface:DataCacheRemove the value stored under the given oid. This does not result in an update of other caches. Rather, it should only be used for removing data in the cache. Meaningful changes to the state of the cache should be made via theDataCache.commit(java.util.Collection<org.apache.openjpa.datacache.DataCachePCData>, java.util.Collection<org.apache.openjpa.datacache.DataCachePCData>, java.util.Collection<org.apache.openjpa.datacache.DataCachePCData>, java.util.Collection<java.lang.Object>)method.
 - 
removeAllpublic java.util.BitSet removeAll(java.util.Collection<java.lang.Object> oids) Description copied from interface:DataCacheRemove the values stored under the given oids.- Specified by:
- removeAllin interface- DataCache
- Returns:
- the indexes of the removed oids
- See Also:
- DataCache.remove(java.lang.Object)
 
 - 
removeAllpublic void removeAll(java.lang.Class<?> cls, boolean subclasses)Description copied from interface:DataCacheEvict all values of a specified type.
 - 
clearpublic void clear() Description copied from interface:DataCacheRemove all data from this cache. This does not result in an update of other caches. Rather, it should only be used for clearing the cache. Meaningful changes to the state of the cache should be made via theDataCache.commit(java.util.Collection<org.apache.openjpa.datacache.DataCachePCData>, java.util.Collection<org.apache.openjpa.datacache.DataCachePCData>, java.util.Collection<org.apache.openjpa.datacache.DataCachePCData>, java.util.Collection<java.lang.Object>)method.
 - 
pinpublic boolean pin(java.lang.Object oid) Description copied from interface:DataCachePin the value stored underoidinto the cache. This method guarantees thatoid's value will not be dropped by the caching algorithm. This method does not affect the behavior ofDataCache.remove(java.lang.Object).
 - 
pinAllpublic java.util.BitSet pinAll(java.util.Collection<java.lang.Object> oids) Description copied from interface:DataCachePin all oids to the cache.- Specified by:
- pinAllin interface- DataCache
- Returns:
- the indexes of the pinned oids
- See Also:
- DataCache.pin(java.lang.Object)
 
 - 
pinAllpublic void pinAll(java.lang.Class<?> cls, boolean subs)Description copied from interface:DataCachePin all oids for the given type.
 - 
unpinpublic boolean unpin(java.lang.Object oid) Description copied from interface:DataCacheUnpin the value stored underoidfrom the cache. This method reverses a previous invocation ofDataCache.pin(java.lang.Object). This method does not remove anything from the cache; it merely makesoid's value a candidate for flushing from the cache.
 - 
unpinAllpublic java.util.BitSet unpinAll(java.util.Collection<java.lang.Object> oids) Description copied from interface:DataCacheUnpin all oids from the cache.- Specified by:
- unpinAllin interface- DataCache
- Returns:
- the indexes of the unpinned oids
- See Also:
- DataCache.unpin(java.lang.Object)
 
 - 
unpinAllpublic void unpinAll(java.lang.Class<?> cls, boolean subs)Description copied from interface:DataCacheUnpin all oids associaed with the given type from the cache.
 - 
writeLockpublic void writeLock() Description copied from interface:DataCacheObtain a write lock on the cache.
 - 
writeUnlockpublic void writeUnlock() Description copied from interface:DataCacheRelease the write lock on the cache.- Specified by:
- writeUnlockin interface- DataCache
 
 - 
addExpirationListenerpublic void addExpirationListener(ExpirationListener listen) Description copied from interface:DataCacheAdd a new expiration event listener to this cache.- Specified by:
- addExpirationListenerin interface- DataCache
 
 - 
removeExpirationListenerpublic boolean removeExpirationListener(ExpirationListener listen) Description copied from interface:DataCacheRemove an expiration event listener from this cache.- Specified by:
- removeExpirationListenerin interface- DataCache
 
 - 
closepublic void close() Description copied from interface:DataCacheFree the resources used by this cache.
 - 
getAllpublic java.util.Map<java.lang.Object,DataCachePCData> getAll(java.util.List<java.lang.Object> keys) Description copied from interface:DataCacheGets objects from the caches for a given list of keys. The returned map has the same keys as the given keys. If the cache does not contain data for a specific key, the returned map still contains the key with a null value.
 - 
getStatisticspublic CacheStatistics getStatistics() Description copied from interface:DataCacheReturns number of read/write request and cache hit ratio data.- Specified by:
- getStatisticsin interface- DataCache
 
 - 
getPartitionpublic DataCache getPartition(java.lang.String name, boolean create) Description copied from interface:DataCacheGets the named partition. Note that a partition itself is another cache.- Specified by:
- getPartitionin interface- DataCache
- Parameters:
- name- name of the given partition.
- create- if true optionally create a new partition.
- Returns:
- a partition of the given name. Or null, if either no such partition exists or can not be created.
 
 - 
getPartitionNamespublic java.util.Set<java.lang.String> getPartitionNames() Description copied from interface:DataCacheGets the name of the known partitions.- Specified by:
- getPartitionNamesin interface- DataCache
- Returns:
- empty set if no partition exists.
 
 - 
isPartitionedpublic boolean isPartitioned() Description copied from interface:DataCacheAffirms if this cache maintains partitions.- Specified by:
- isPartitionedin interface- DataCache
 
 - 
getEvictOnBulkUpdatepublic boolean getEvictOnBulkUpdate() Description copied from interface:DataCacheReturns whether the the cache needs to be updated when bulk updates as executed. Defaults to true.- Specified by:
- getEvictOnBulkUpdatein interface- DataCache
 
 
- 
 
-