org.hibernate.cache.infinispan.access

Class InvalidationCacheAccessDelegate

java.lang.Object

org.hibernate.cache.infinispan.access.InvalidationCacheAccessDelegate

All Implemented Interfaces:

AccessDelegate

Direct Known Subclasses:

NonTxInvalidationCacheAccessDelegate, TxInvalidationCacheAccessDelegate

public abstract class InvalidationCacheAccessDelegate
extends Object
implements AccessDelegate

Since:

3.5

Field Summary

Fields

Modifier and Type	Field and Description
protected org.infinispan.AdvancedCache	cache
protected static org.infinispan.util.logging.Log	log
protected PutFromLoadValidator	putValidator
protected BaseRegion	region
protected static boolean	TRACE_ENABLED
protected org.infinispan.AdvancedCache<Object,Object>	writeCache

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	InvalidationCacheAccessDelegate(BaseRegion region, PutFromLoadValidator validator) Create a new transactional access delegate instance.

Method Summary

Modifier and Type	Method and Description
void	evict(Object key) Forcibly evict an item from the cache immediately without regard for transaction isolation.
void	evictAll() Forcibly evict all items from the cache immediately without regard for transaction isolation.
Object	get(SessionImplementor session, Object key, long txTimestamp) Attempt to retrieve an object from the cache.
boolean	putFromLoad(SessionImplementor session, Object key, Object value, long txTimestamp, Object version) Attempt to cache an object, after loading from the database.
boolean	putFromLoad(SessionImplementor session, Object key, Object value, long txTimestamp, Object version, boolean minimalPutOverride) Attempt to cache an object, after loading from the database, explicitly specifying the minimalPut behavior.
void	remove(SessionImplementor session, Object key) Called after an item has become stale (before the transaction completes).
void	removeAll() Called to evict data from the entire region
void	unlockItem(SessionImplementor session, Object key) Called when we have finished the attempted update/delete (which may or may not have been successful), after transaction completion.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.hibernate.cache.infinispan.access.AccessDelegate

afterInsert, afterUpdate, insert, update

Field Detail

log

protected static final org.infinispan.util.logging.Log log

TRACE_ENABLED

protected static final boolean TRACE_ENABLED

cache

protected final org.infinispan.AdvancedCache cache

region

protected final BaseRegion region

putValidator

protected final PutFromLoadValidator putValidator

writeCache

protected final org.infinispan.AdvancedCache<Object,Object> writeCache

Constructor Detail

InvalidationCacheAccessDelegate

protected InvalidationCacheAccessDelegate(BaseRegion region,
                                          PutFromLoadValidator validator)

Create a new transactional access delegate instance.

Parameters:

region - to control access to

validator - put from load validator

Method Detail

get

public Object get(SessionImplementor session,
                  Object key,
                  long txTimestamp)
           throws CacheException

Attempt to retrieve an object from the cache.

Specified by:

get in interface AccessDelegate

Parameters:

session -

key - The key of the item to be retrieved

txTimestamp - a timestamp prior to the transaction start time

Returns:

the cached object or null

Throws:

CacheException - if the cache retrieval failed

putFromLoad

public boolean putFromLoad(SessionImplementor session,
                           Object key,
                           Object value,
                           long txTimestamp,
                           Object version)

Description copied from interface: AccessDelegate

Attempt to cache an object, after loading from the database.

Specified by:

putFromLoad in interface AccessDelegate

Parameters:

session - Current session

key - The item key

value - The item

txTimestamp - a timestamp prior to the transaction start time

version - the item version number

Returns:

true if the object was successfully cached

putFromLoad

public boolean putFromLoad(SessionImplementor session,
                           Object key,
                           Object value,
                           long txTimestamp,
                           Object version,
                           boolean minimalPutOverride)
                    throws CacheException

Attempt to cache an object, after loading from the database, explicitly specifying the minimalPut behavior.

Specified by:

putFromLoad in interface AccessDelegate

Parameters:

session - Current session

key - The item key

value - The item

txTimestamp - a timestamp prior to the transaction start time

version - the item version number

minimalPutOverride - Explicit minimalPut flag

Returns:

true if the object was successfully cached

Throws:

CacheException - if storing the object failed

remove

public void remove(SessionImplementor session,
                   Object key)
            throws CacheException

Description copied from interface: AccessDelegate

Called after an item has become stale (before the transaction completes).

Specified by:

remove in interface AccessDelegate

Parameters:

session - Current session

key - The key of the item to remove

Throws:

CacheException - if removing the cached item fails

removeAll

public void removeAll()
               throws CacheException

Description copied from interface: AccessDelegate

Called to evict data from the entire region

Specified by:

removeAll in interface AccessDelegate

Throws:

CacheException - if eviction the region fails

evict

public void evict(Object key)
           throws CacheException

Description copied from interface: AccessDelegate

Forcibly evict an item from the cache immediately without regard for transaction isolation.

Specified by:

evict in interface AccessDelegate

Parameters:

key - The key of the item to remove

Throws:

CacheException - if evicting the item fails

evictAll

public void evictAll()
              throws CacheException

Description copied from interface: AccessDelegate

Forcibly evict all items from the cache immediately without regard for transaction isolation.

Specified by:

evictAll in interface AccessDelegate

Throws:

CacheException - if evicting items fails

unlockItem

public void unlockItem(SessionImplementor session,
                       Object key)
                throws CacheException

Description copied from interface: AccessDelegate

Called when we have finished the attempted update/delete (which may or may not have been successful), after transaction completion. This method is used by "asynchronous" concurrency strategies.

Specified by:

unlockItem in interface AccessDelegate

key - The item key

Throws:

CacheException - Propogated from underlying Region