org.hibernate.cache.infinispan.access

Interface AccessDelegate

All Known Implementing Classes:

InvalidationCacheAccessDelegate, NonStrictAccessDelegate, NonTxInvalidationCacheAccessDelegate, TombstoneAccessDelegate, TxInvalidationCacheAccessDelegate

public interface AccessDelegate

Defines the strategy for access to entity or collection data in a Infinispan instance.

The intent of this class is to encapsulate common code and serve as a delegate for EntityRegionAccessStrategy and CollectionRegionAccessStrategy implementations.

Method Summary

Modifier and Type	Method and Description
boolean	afterInsert(SessionImplementor session, Object key, Object value, Object version) Called after an item has been inserted (after the transaction completes), instead of calling release().
boolean	afterUpdate(SessionImplementor session, Object key, Object value, Object currentVersion, Object previousVersion, SoftLock lock) Called after an item has been updated (after the transaction completes), instead of calling release().
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)
boolean	insert(SessionImplementor session, Object key, Object value, Object version) Called after an item has been inserted (before the transaction completes), instead of calling evict().
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.
boolean	update(SessionImplementor session, Object key, Object value, Object currentVersion, Object previousVersion) Called after an item has been updated (before the transaction completes), instead of calling evict().

Method Detail

get

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

Throws:

CacheException

putFromLoad

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

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

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

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.

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 - Propogated from underlying Region

insert

boolean insert(SessionImplementor session,
               Object key,
               Object value,
               Object version)
        throws CacheException

Called after an item has been inserted (before the transaction completes), instead of calling evict().

Parameters:

session - Current session

key - The item key

value - The item

version - The item's version value

Returns:

Were the contents of the cache actual changed by this operation?

Throws:

CacheException - if the insert fails

update

boolean update(SessionImplementor session,
               Object key,
               Object value,
               Object currentVersion,
               Object previousVersion)
        throws CacheException

Called after an item has been updated (before the transaction completes), instead of calling evict().

Parameters:

session - Current session

key - The item key

value - The item

currentVersion - The item's current version value

previousVersion - The item's previous version value

Returns:

Whether the contents of the cache actual changed by this operation

Throws:

CacheException - if the update fails

remove

void remove(SessionImplementor session,
            Object key)
     throws CacheException

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

Parameters:

session - Current session

key - The key of the item to remove

Throws:

CacheException - if removing the cached item fails

removeAll

void removeAll()
        throws CacheException

Called to evict data from the entire region

Throws:

CacheException - if eviction the region fails

evict

void evict(Object key)
    throws CacheException

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

Parameters:

key - The key of the item to remove

Throws:

CacheException - if evicting the item fails

evictAll

void evictAll()
       throws CacheException

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

Throws:

CacheException - if evicting items fails

unlockItem

void unlockItem(SessionImplementor session,
                Object key)
         throws CacheException

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.

Parameters:

session -

key - The item key

Throws:

CacheException - Propogated from underlying Region

afterInsert

boolean afterInsert(SessionImplementor session,
                    Object key,
                    Object value,
                    Object version)

Called after an item has been inserted (after the transaction completes), instead of calling release(). This method is used by "asynchronous" concurrency strategies.

Parameters:

session -

key - The item key

value - The item

version - The item's version value

Returns:

Were the contents of the cache actual changed by this operation?

Throws:

CacheException - Propagated from underlying Region

afterUpdate

boolean afterUpdate(SessionImplementor session,
                    Object key,
                    Object value,
                    Object currentVersion,
                    Object previousVersion,
                    SoftLock lock)

Called after an item has been updated (after the transaction completes), instead of calling release(). This method is used by "asynchronous" concurrency strategies.

Parameters:

session -

key - The item key

value - The item

currentVersion - The item's current version value

previousVersion - The item's previous version value

lock - The lock previously obtained from #lockItem

Returns:

Were the contents of the cache actual changed by this operation?

Throws:

CacheException - Propagated from underlying Region