org.hibernate.cache.spi

Class UpdateTimestampsCache

java.lang.Object

org.hibernate.cache.spi.UpdateTimestampsCache

public class UpdateTimestampsCache
extends java.lang.Object

Tracks the timestamps of the most recent updates to particular tables. It is important that the cache timeout of the underlying cache implementation be set to a higher value than the timeouts of any of the query caches. In fact, we recommend that the the underlying cache not be configured for expiry at all. Note, in particular, that an LRU cache expiry policy is never appropriate.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	REGION_NAME The region name of the update-timestamps cache.

Constructor Summary

Constructors

Constructor and Description
UpdateTimestampsCache(SessionFactoryImplementor sessionFactory, TimestampsRegion region) Constructs an UpdateTimestampsCache.

Method Summary

Modifier and Type	Method and Description
void	clear() Clear the update-timestamps data.
void	destroy() Destroys the cache.
TimestampsRegion	getRegion() Get the underlying cache region where data is stored..
void	invalidate(java.io.Serializable[] spaces, SharedSessionContractImplementor session) Perform invalidation.
boolean	isUpToDate(java.util.Set<java.io.Serializable> spaces, java.lang.Long timestamp, SharedSessionContractImplementor session) Perform an up-to-date check for the given set of query spaces.
void	preInvalidate(java.io.Serializable[] spaces, SharedSessionContractImplementor session) Perform pre-invalidation.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

REGION_NAME

public static final java.lang.String REGION_NAME

The region name of the update-timestamps cache.

Constructor Detail

UpdateTimestampsCache

public UpdateTimestampsCache(SessionFactoryImplementor sessionFactory,
                             TimestampsRegion region)

Constructs an UpdateTimestampsCache.

Parameters:

sessionFactory - The SessionFactory

region - The underlying second level cache region to use.

Method Detail

preInvalidate

public void preInvalidate(java.io.Serializable[] spaces,
                          SharedSessionContractImplementor session)
                   throws CacheException

Perform pre-invalidation.

Parameters:

spaces - The spaces to pre-invalidate

session -

Throws:

CacheException - Indicated problem delegating to underlying region.

invalidate

public void invalidate(java.io.Serializable[] spaces,
                       SharedSessionContractImplementor session)
                throws CacheException

Perform invalidation.

Parameters:

spaces - The spaces to invalidate.

session -

Throws:

CacheException - Indicated problem delegating to underlying region.

isUpToDate

public boolean isUpToDate(java.util.Set<java.io.Serializable> spaces,
                          java.lang.Long timestamp,
                          SharedSessionContractImplementor session)
                   throws CacheException

Perform an up-to-date check for the given set of query spaces.

Parameters:

spaces - The spaces to check

timestamp - The timestamp against which to check.

session -

Returns:

Whether all those spaces are up-to-date

Throws:

CacheException - Indicated problem delegating to underlying region.

clear

public void clear()
           throws CacheException

Clear the update-timestamps data.

Throws:

CacheException - Indicates problem delegating call to underlying region.

destroy

public void destroy()

Destroys the cache.

Throws:

CacheException - Indicates problem delegating call to underlying region.

getRegion

public TimestampsRegion getRegion()

Get the underlying cache region where data is stored..

Returns:

The underlying region.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object