Interface TimestampsCache

public interface TimestampsCache

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.

Method Summary

Modifier and Type	Method	Description
void	clear()
default void	destroy()	Deprecated, for removal: This API element is subject to removal in a future version. This noop method is never called
TimestampsRegion	getRegion()	Deprecated. This method is never called.
void	invalidate(String[] spaces, SharedSessionContractImplementor session)	Perform invalidation of the passed spaces (table names) against the timestamp region data.
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.
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.
void	preInvalidate(String[] spaces, SharedSessionContractImplementor session)	Perform pre-invalidation of the passed spaces (table names) against the timestamp region data.

Method Details

getRegion

@Nullable
TimestampsRegion getRegion()

Deprecated.

This method is never called.

The region used to store all timestamp data, or null of the timestamp cache is not enabled.

preInvalidate

void preInvalidate(@Nonnull
 String[] spaces,
 @Nonnull
 SharedSessionContractImplementor session)

Perform pre-invalidation of the passed spaces (table names) against the timestamp region data.

invalidate

void invalidate(@Nonnull
 String[] spaces,
 @Nonnull
 SharedSessionContractImplementor session)

Perform invalidation of the passed spaces (table names) against the timestamp region data.

isUpToDate

boolean isUpToDate(@Nonnull
 String[] spaces,
 @Nonnull
 Long timestamp,
 @Nonnull
 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

boolean isUpToDate(@Nonnull
 Collection<String> spaces,
 @Nonnull
 Long timestamp,
 @Nonnull
 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.

clear

void clear()
    throws CacheException

Throws:

CacheException

destroy

@Deprecated(since="8.0",
            forRemoval=true)
default void destroy()

Deprecated, for removal: This API element is subject to removal in a future version.

This noop method is never called