org.hibernate.testing.cache

Class AbstractReadWriteAccessStrategy

java.lang.Object

org.hibernate.testing.cache.BaseRegionAccessStrategy

org.hibernate.testing.cache.AbstractReadWriteAccessStrategy

All Implemented Interfaces:

org.hibernate.cache.spi.access.RegionAccessStrategy

Direct Known Subclasses:

ReadWriteEntityRegionAccessStrategy

public abstract class AbstractReadWriteAccessStrategy
extends BaseRegionAccessStrategy

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractReadWriteAccessStrategy.Item Wrapper type representing unlocked items.
static class	AbstractReadWriteAccessStrategy.Lock Wrapper type representing locked items.
static interface	AbstractReadWriteAccessStrategy.Lockable Interface type implemented by all wrapper objects in the cache.

Field Summary

Fields

Modifier and Type	Field and Description
protected Lock	readLock
protected Lock	writeLock

Constructor Summary

Constructors

Constructor and Description
AbstractReadWriteAccessStrategy()

Method Summary

Modifier and Type	Method and Description
protected void	decrementLock(org.hibernate.engine.spi.SharedSessionContractImplementor session, Object key, AbstractReadWriteAccessStrategy.Lock lock) Unlock and re-put the given key, lock combination.
Object	get(org.hibernate.engine.spi.SharedSessionContractImplementor session, Object key, long txTimestamp) Returns <code>null</code> if the item is not readable.
protected void	handleLockExpiry(org.hibernate.engine.spi.SharedSessionContractImplementor session, Object key, AbstractReadWriteAccessStrategy.Lockable lock) Handle the timeout of a previous lock mapped to this key
org.hibernate.cache.spi.access.SoftLock	lockItem(org.hibernate.engine.spi.SharedSessionContractImplementor session, Object key, Object version) Soft-lock a cache item.
boolean	putFromLoad(org.hibernate.engine.spi.SharedSessionContractImplementor session, Object key, Object value, long txTimestamp, Object version, boolean minimalPutOverride) Returns <code>false</code> and fails to put the value if there is an existing un-writeable item mapped to this key.
void	unlockItem(org.hibernate.engine.spi.SharedSessionContractImplementor session, Object key, org.hibernate.cache.spi.access.SoftLock lock) Soft-unlock a cache item.

Methods inherited from class org.hibernate.testing.cache.BaseRegionAccessStrategy

evict, evictAll, getInternalRegion, isDefaultMinimalPutOverride, lockRegion, putFromLoad, remove, removeAll, unlockRegion

Methods inherited from class java.lang.Object

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

Field Detail

readLock

protected Lock readLock

writeLock

protected Lock writeLock

Constructor Detail

AbstractReadWriteAccessStrategy

public AbstractReadWriteAccessStrategy()

Method Detail

get

public final Object get(org.hibernate.engine.spi.SharedSessionContractImplementor session,
                        Object key,
                        long txTimestamp)
                 throws org.hibernate.cache.CacheException

Returns <code>null</code> if the item is not readable. Locked items are not readable, nor are items created after the start of this transaction.

Specified by:

get in interface org.hibernate.cache.spi.access.RegionAccessStrategy

Overrides:

get in class BaseRegionAccessStrategy

Throws:

org.hibernate.cache.CacheException

putFromLoad

public final boolean putFromLoad(org.hibernate.engine.spi.SharedSessionContractImplementor session,
                                 Object key,
                                 Object value,
                                 long txTimestamp,
                                 Object version,
                                 boolean minimalPutOverride)
                          throws org.hibernate.cache.CacheException

Returns <code>false</code> and fails to put the value if there is an existing un-writeable item mapped to this key.

Specified by:

putFromLoad in interface org.hibernate.cache.spi.access.RegionAccessStrategy

Overrides:

putFromLoad in class BaseRegionAccessStrategy

Throws:

org.hibernate.cache.CacheException

lockItem

public final org.hibernate.cache.spi.access.SoftLock lockItem(org.hibernate.engine.spi.SharedSessionContractImplementor session,
                                                              Object key,
                                                              Object version)
                                                       throws org.hibernate.cache.CacheException

Soft-lock a cache item.

Specified by:

lockItem in interface org.hibernate.cache.spi.access.RegionAccessStrategy

Overrides:

lockItem in class BaseRegionAccessStrategy

Throws:

org.hibernate.cache.CacheException

unlockItem

public final void unlockItem(org.hibernate.engine.spi.SharedSessionContractImplementor session,
                             Object key,
                             org.hibernate.cache.spi.access.SoftLock lock)
                      throws org.hibernate.cache.CacheException

Soft-unlock a cache item.

Specified by:

unlockItem in interface org.hibernate.cache.spi.access.RegionAccessStrategy

Overrides:

unlockItem in class BaseRegionAccessStrategy

Throws:

org.hibernate.cache.CacheException

decrementLock

protected void decrementLock(org.hibernate.engine.spi.SharedSessionContractImplementor session,
                             Object key,
                             AbstractReadWriteAccessStrategy.Lock lock)

Unlock and re-put the given key, lock combination.

handleLockExpiry

protected void handleLockExpiry(org.hibernate.engine.spi.SharedSessionContractImplementor session,
                                Object key,
                                AbstractReadWriteAccessStrategy.Lockable lock)

Handle the timeout of a previous lock mapped to this key