org.hibernate.cache.spi.support

Class AbstractNaturalIdDataAccess

java.lang.Object

org.hibernate.cache.spi.support.AbstractCachedDomainDataAccess

org.hibernate.cache.spi.support.AbstractNaturalIdDataAccess

All Implemented Interfaces:

CachedDomainDataAccess, NaturalIdDataAccess, AbstractDomainDataRegion.Destructible

Direct Known Subclasses:

NaturalIdNonStrictReadWriteAccess, NaturalIdReadOnlyAccess, NaturalIdTransactionalAccess

public abstract class AbstractNaturalIdDataAccess
extends AbstractCachedDomainDataAccess
implements NaturalIdDataAccess

Author:

Steve Ebersole

Constructor Summary

Constructors

Constructor and Description
AbstractNaturalIdDataAccess(DomainDataRegion region, CacheKeysFactory keysFactory, DomainDataStorageAccess storageAccess, NaturalIdDataCachingConfig config)

Method Summary

Modifier and Type	Method and Description
boolean	afterInsert(SharedSessionContractImplementor session, Object key, Object value) Called afterQuery an item has been inserted (afterQuery the transaction completes), instead of calling release().
boolean	afterUpdate(SharedSessionContractImplementor session, Object key, Object value, SoftLock lock) Called afterQuery an item has been updated (afterQuery the transaction completes), instead of calling release().
Object	generateCacheKey(Object[] naturalIdValues, EntityPersister persister, SharedSessionContractImplementor session) To create instances of NaturalIdCacheKey for this region, Hibernate will invoke this method exclusively so that generated implementations can generate optimised keys.
Object[]	getNaturalIdValues(Object cacheKey) Performs reverse operation to NaturalIdDataAccess.generateCacheKey(java.lang.Object[], org.hibernate.persister.entity.EntityPersister, org.hibernate.engine.spi.SharedSessionContractImplementor), returning the original naturalIdValues.
boolean	insert(SharedSessionContractImplementor session, Object key, Object value) Called afterQuery an item has been inserted (beforeQuery the transaction completes), instead of calling evict().
SoftLock	lockItem(SharedSessionContractImplementor session, Object key, Object version) We are going to attempt to update/delete the keyed object.
SoftLock	lockRegion() Lock the entire region
void	unlockItem(SharedSessionContractImplementor session, Object key, SoftLock lock) Called when we have finished the attempted update/delete (which may or may not have been successful), after transaction completion.
void	unlockRegion(SoftLock lock) Called after we have finished the attempted invalidation of the entire region
boolean	update(SharedSessionContractImplementor session, Object key, Object value) Called afterQuery an item has been updated (beforeQuery the transaction completes), instead of calling evict().

Methods inherited from class org.hibernate.cache.spi.support.AbstractCachedDomainDataAccess

clearCache, contains, destroy, evict, evictAll, get, getRegion, getStorageAccess, putFromLoad, putFromLoad, remove, removeAll

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.spi.access.CachedDomainDataAccess

contains, evict, evictAll, get, getAccessType, getRegion, putFromLoad, putFromLoad, remove, removeAll

Constructor Detail

AbstractNaturalIdDataAccess

public AbstractNaturalIdDataAccess(DomainDataRegion region,
                                   CacheKeysFactory keysFactory,
                                   DomainDataStorageAccess storageAccess,
                                   NaturalIdDataCachingConfig config)

Method Detail

generateCacheKey

public Object generateCacheKey(Object[] naturalIdValues,
                               EntityPersister persister,
                               SharedSessionContractImplementor session)

Description copied from interface: NaturalIdDataAccess

To create instances of NaturalIdCacheKey for this region, Hibernate will invoke this method exclusively so that generated implementations can generate optimised keys.

Specified by:

generateCacheKey in interface NaturalIdDataAccess

Parameters:

naturalIdValues - the sequence of values which unequivocally identifies a cached element on this region

persister - the persister of the element being cached

Returns:

a key which can be used to identify this an element unequivocally on this same region

getNaturalIdValues

public Object[] getNaturalIdValues(Object cacheKey)

Description copied from interface: NaturalIdDataAccess

Performs reverse operation to NaturalIdDataAccess.generateCacheKey(java.lang.Object[], org.hibernate.persister.entity.EntityPersister, org.hibernate.engine.spi.SharedSessionContractImplementor), returning the original naturalIdValues.

Specified by:

getNaturalIdValues in interface NaturalIdDataAccess

Parameters:

cacheKey - key returned from NaturalIdDataAccess.generateCacheKey(java.lang.Object[], org.hibernate.persister.entity.EntityPersister, org.hibernate.engine.spi.SharedSessionContractImplementor)

Returns:

the sequence of values which unequivocally identifies a cached element on this region

insert

public boolean insert(SharedSessionContractImplementor session,
                      Object key,
                      Object value)

Description copied from interface: NaturalIdDataAccess

Called afterQuery an item has been inserted (beforeQuery the transaction completes), instead of calling evict(). This method is used by "synchronous" concurrency strategies.

Specified by:

insert in interface NaturalIdDataAccess

Parameters:

session - Current session

key - The item key

value - The item

Returns:

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

afterInsert

public boolean afterInsert(SharedSessionContractImplementor session,
                           Object key,
                           Object value)

Description copied from interface: NaturalIdDataAccess

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

Specified by:

afterInsert in interface NaturalIdDataAccess

Parameters:

session - Current session

key - The item key

value - The item

Returns:

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

update

public boolean update(SharedSessionContractImplementor session,
                      Object key,
                      Object value)

Description copied from interface: NaturalIdDataAccess

Called afterQuery an item has been updated (beforeQuery the transaction completes), instead of calling evict(). This method is used by "synchronous" concurrency strategies.

Specified by:

update in interface NaturalIdDataAccess

Parameters:

session - Current session

key - The item key

value - The item

Returns:

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

afterUpdate

public boolean afterUpdate(SharedSessionContractImplementor session,
                           Object key,
                           Object value,
                           SoftLock lock)

Description copied from interface: NaturalIdDataAccess

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

Specified by:

afterUpdate in interface NaturalIdDataAccess

Parameters:

session - Current session

key - The item key

value - The item

lock - The lock previously obtained from CachedDomainDataAccess.lockItem(org.hibernate.engine.spi.SharedSessionContractImplementor, java.lang.Object, java.lang.Object)

Returns:

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

lockRegion

public SoftLock lockRegion()

Description copied from interface: CachedDomainDataAccess

Lock the entire region

Specified by:

lockRegion in interface CachedDomainDataAccess

Overrides:

lockRegion in class AbstractCachedDomainDataAccess

Returns:

A representation of our lock on the item; or null.

unlockRegion

public void unlockRegion(SoftLock lock)

Description copied from interface: CachedDomainDataAccess

Called after we have finished the attempted invalidation of the entire region

Specified by:

unlockRegion in interface CachedDomainDataAccess

Overrides:

unlockRegion in class AbstractCachedDomainDataAccess

Parameters:

lock - The lock previously obtained from CachedDomainDataAccess.lockRegion()

lockItem

public SoftLock lockItem(SharedSessionContractImplementor session,
                         Object key,
                         Object version)

Description copied from interface: CachedDomainDataAccess

We are going to attempt to update/delete the keyed object. This method is used by "asynchronous" concurrency strategies.

The returned object must be passed back to CachedDomainDataAccess.unlockItem(org.hibernate.engine.spi.SharedSessionContractImplementor, java.lang.Object, org.hibernate.cache.spi.access.SoftLock), to release the lock. Concurrency strategies which do not support client-visible locks may silently return null.

Specified by:

lockItem in interface CachedDomainDataAccess

Parameters:

session - Current session.

key - The key of the item to lock

version - The item's current version value

Returns:

A representation of our lock on the item; or null.

unlockItem

public void unlockItem(SharedSessionContractImplementor session,
                       Object key,
                       SoftLock lock)

Description copied from interface: CachedDomainDataAccess

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 CachedDomainDataAccess

Parameters:

session - Current session.

key - The item key

lock - The lock previously obtained from CachedDomainDataAccess.lockItem(org.hibernate.engine.spi.SharedSessionContractImplementor, java.lang.Object, java.lang.Object)