ehcache

net.sf.ehcache.hibernate.regions
Class EhcacheTransactionalDataRegion

java.lang.Object
  extended by net.sf.ehcache.hibernate.regions.EhcacheDataRegion
      extended by net.sf.ehcache.hibernate.regions.EhcacheTransactionalDataRegion
Direct Known Subclasses:
EhcacheCollectionRegion, EhcacheEntityRegion

public class EhcacheTransactionalDataRegion
extends EhcacheDataRegion

An Ehcache specific TransactionalDataRegion.

This is the common superclass entity and collection regions.

Author:
Chris Dennis, Greg Luck, Emmanuel Bernard, Abhishek Sanoujam

Field Summary
protected  CacheDataDescription metadata
          Metadata associated with the objects stored in the region.
protected  Settings settings
          Hibernate settings associated with the persistence unit.
 
Fields inherited from class net.sf.ehcache.hibernate.regions.EhcacheDataRegion
accessStrategyFactory, cache
 
Method Summary
 void clear()
          Remove all mapping from this cache region.
 Object get(Object key)
          Get the value mapped to this key, or null if no value is mapped to this key.
 CacheDataDescription getCacheDataDescription()
          
 Settings getSettings()
          Return the hibernate settings
 boolean isTransactionAware()
          
 boolean locksAreIndependentOfCache()
          Returns true if the locks used by the locking methods of this region are the independent of the cache.
 void put(Object key, Object value)
          Map the given value to the given key, replacing any existing mapping for this key this unpins the key in the cache should it be currently pinned
 void putEternal(Object key, Object value)
          Map the given value to the given key, replacing any existing mapping for this key, pinning the key in the cache
 void readLock(Object key)
          Attempts to read lock the mapping for the given key.
 void readUnlock(Object key)
          Attempts to read unlock the mapping for the given key.
 void remove(Object key)
          Remove the mapping for this key (if any exists).
 void writeLock(Object key)
          Attempts to write lock the mapping for the given key.
 void writeUnlock(Object key)
          Attempts to write unlock the mapping for the given key.
 
Methods inherited from class net.sf.ehcache.hibernate.regions.EhcacheDataRegion
contains, destroy, getEhcache, getElementCountInMemory, getElementCountOnDisk, getName, getSizeInMemory, getTimeout, nextTimestamp, toMap
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

settings

protected final Settings settings
Hibernate settings associated with the persistence unit.


metadata

protected final CacheDataDescription metadata
Metadata associated with the objects stored in the region.

Method Detail

getSettings

public Settings getSettings()
Return the hibernate settings

Returns:
settings

isTransactionAware

public boolean isTransactionAware()


getCacheDataDescription

public CacheDataDescription getCacheDataDescription()


get

public final Object get(Object key)
Get the value mapped to this key, or null if no value is mapped to this key.


put

public final void put(Object key,
                      Object value)
               throws CacheException
Map the given value to the given key, replacing any existing mapping for this key this unpins the key in the cache should it be currently pinned

Throws:
CacheException

putEternal

public final void putEternal(Object key,
                             Object value)
                      throws CacheException
Map the given value to the given key, replacing any existing mapping for this key, pinning the key in the cache

Throws:
CacheException

remove

public final void remove(Object key)
                  throws CacheException
Remove the mapping for this key (if any exists).

Throws:
CacheException

clear

public final void clear()
                 throws CacheException
Remove all mapping from this cache region.

Throws:
CacheException

writeLock

public final void writeLock(Object key)
Attempts to write lock the mapping for the given key.


writeUnlock

public final void writeUnlock(Object key)
Attempts to write unlock the mapping for the given key.


readLock

public final void readLock(Object key)
Attempts to read lock the mapping for the given key.


readUnlock

public final void readUnlock(Object key)
Attempts to read unlock the mapping for the given key.


locksAreIndependentOfCache

public final boolean locksAreIndependentOfCache()
Returns true if the locks used by the locking methods of this region are the independent of the cache.

Independent locks are not locked by the cache when the cache is accessed directly. This means that for an independent lock lock holds taken through a region method will not block direct access to the cache via other means.


ehcache

Copyright 2001-2014, Terracotta, Inc.