org.hibernate.cache.internal

Class StandardQueryCache

java.lang.Object

org.hibernate.cache.internal.StandardQueryCache

All Implemented Interfaces:

QueryCache

public class StandardQueryCache
extends java.lang.Object
implements QueryCache

The standard implementation of the Hibernate QueryCache interface. This implementation is very good at recognizing stale query results and and re-running queries when it detects this condition, re-caching the new results.

Constructor Summary

Constructors

Constructor and Description
StandardQueryCache(QueryResultsRegion cacheRegion, CacheImplementor cacheManager)
StandardQueryCache(SessionFactoryOptions settings, java.util.Properties props, UpdateTimestampsCache updateTimestampsCache, java.lang.String regionName) Constructs a StandardQueryCache instance

Method Summary

Modifier and Type	Method and Description
void	clear() Clear items from the query cache.
void	destroy() Destroy the cache.
java.util.List	get(QueryKey key, Type[] returnTypes, boolean isNaturalKeyLookup, java.util.Set<java.io.Serializable> spaces, SharedSessionContractImplementor session) Get results from the cache.
QueryResultsRegion	getRegion() The underlying cache factory region being used.
protected boolean	isUpToDate(java.util.Set<java.io.Serializable> spaces, java.lang.Long timestamp, SharedSessionContractImplementor session)
boolean	put(QueryKey key, Type[] returnTypes, java.util.List result, boolean isNaturalKeyLookup, SharedSessionContractImplementor session) Put a result into the query cache.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

StandardQueryCache

public StandardQueryCache(SessionFactoryOptions settings,
                          java.util.Properties props,
                          UpdateTimestampsCache updateTimestampsCache,
                          java.lang.String regionName)

Constructs a StandardQueryCache instance

Parameters:

settings - The SessionFactory settings.

props - Any properties

updateTimestampsCache - The update-timestamps cache to use.

regionName - The base query cache region name

StandardQueryCache

public StandardQueryCache(QueryResultsRegion cacheRegion,
                          CacheImplementor cacheManager)

Method Detail

getRegion

public QueryResultsRegion getRegion()

Description copied from interface: QueryCache

The underlying cache factory region being used.

Specified by:

getRegion in interface QueryCache

Returns:

The cache region.

destroy

public void destroy()

Description copied from interface: QueryCache

Destroy the cache.

Specified by:

destroy in interface QueryCache

clear

public void clear()
           throws CacheException

Description copied from interface: QueryCache

Clear items from the query cache.

Specified by:

clear in interface QueryCache

Throws:

CacheException - Indicates a problem delegating to the underlying cache.

put

public boolean put(QueryKey key,
                   Type[] returnTypes,
                   java.util.List result,
                   boolean isNaturalKeyLookup,
                   SharedSessionContractImplementor session)
            throws HibernateException

Description copied from interface: QueryCache

Put a result into the query cache.

Specified by:

put in interface QueryCache

Parameters:

key - The cache key

returnTypes - The result types

result - The results to cache

isNaturalKeyLookup - Was this a natural id lookup?

session - The originating session

Returns:

Whether the put actually happened.

Throws:

HibernateException - Indicates a problem delegating to the underlying cache.

get

public java.util.List get(QueryKey key,
                          Type[] returnTypes,
                          boolean isNaturalKeyLookup,
                          java.util.Set<java.io.Serializable> spaces,
                          SharedSessionContractImplementor session)
                   throws HibernateException

Description copied from interface: QueryCache

Get results from the cache.

Specified by:

get in interface QueryCache

Parameters:

key - The cache key

returnTypes - The result types

isNaturalKeyLookup - Was this a natural id lookup?

spaces - The query spaces (used in invalidation plus validation checks)

session - The originating session

Returns:

The cached results; may be null.

Throws:

HibernateException - Indicates a problem delegating to the underlying cache.

isUpToDate

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

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object