Top Description Methods

org.hibernate.cache.spi

public Interface TimestampsCache

Known Direct Implementers: org.hibernate.cache.internal.TimestampsCacheDisabledImpl, org.hibernate.cache.internal.TimestampsCacheEnabledImpl
Imports: java.util.Collection, org.hibernate.cache.CacheException, org.hibernate.engine.spi.SharedSessionContractImplementor

Tracks invalidation of "query spaces" (tables) for the purpose of determining if a cached query result set is stale. Implementations use a special region the second-level cache to store invalidation timestamps.

A query space is invalidated in the TimestampsCache when a SQL DML statement executed by Hibernate affects the corresponding table.
A cached query result set is checked for staleness against the TimestampsCache when it is read from a QueryResultsRegion by a QueryResultsCache.

Author: Steve Ebersole

Method Summary

Modifier and Type	Method and Description
public default void	clear()
public default void	destroy()
public TimestampsRegion	getRegion() The region used to store all timestamp data.
public void	invalidate(String[] spaces, SharedSessionContractImplementor session) Perform invalidation of the passed spaces (table names) against the timestamp region data.
public boolean	isUpToDate(String[] spaces, Long timestamp, SharedSessionContractImplementor session) Perform an up-to-date check for the given set of query spaces as part of verifying the validity of cached query results.
public boolean	isUpToDate(Collection<String> spaces, Long timestamp, SharedSessionContractImplementor session) Perform an up-to-date check for the given set of query spaces as part of verifying the validity of cached query results.
public void	preInvalidate(String[] spaces, SharedSessionContractImplementor session) Perform pre-invalidation of the passed spaces (table names) against the timestamp region data.

Method Detail

clear	back to summary
public default void clear() throws CacheException

destroy	back to summary
public default void destroy()

getRegion	back to summary
public TimestampsRegion getRegion() The region used to store all timestamp data.

invalidate	back to summary
public void invalidate(String[] spaces, SharedSessionContractImplementor session) Perform invalidation of the passed spaces (table names) against the timestamp region data.

isUpToDate	back to summary
public boolean isUpToDate(String[] spaces, Long timestamp, SharedSessionContractImplementor session) Perform an up-to-date check for the given set of query spaces as part of verifying the validity of cached query results.

isUpToDate	back to summary
public boolean isUpToDate(Collection<String> spaces, Long timestamp, SharedSessionContractImplementor session) Perform an up-to-date check for the given set of query spaces as part of verifying the validity of cached query results.

preInvalidate	back to summary
public void preInvalidate(String[] spaces, SharedSessionContractImplementor session) Perform pre-invalidation of the passed spaces (table names) against the timestamp region data.