Class JavaxCacheQueryResultCache

java.lang.Object

org.datanucleus.store.query.cache.AbstractQueryResultsCache

org.datanucleus.store.query.cache.JavaxCacheQueryResultCache

All Implemented Interfaces:

Serializable, QueryResultsCache

public class JavaxCacheQueryResultCache
extends AbstractQueryResultsCache

Implementation of a query results cache using javax.cache (v0.3+) interface.

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private javax.cache.Cache	cache
private static final long	serialVersionUID

Fields inherited from class AbstractQueryResultsCache

cacheName, clearAtClose, expiryMillis, maxSize, nucleusCtx

Constructor Summary

Constructors

Constructor	Description
JavaxCacheQueryResultCache(NucleusContext nucleusCtx)	Constructor.

Method Summary

Modifier and Type	Method	Description
void	close()	Method to close the cache when no longer needed.
boolean	contains(String queryKey)	Accessor for whether the specified query is in the cache
void	evict(Class candidate)	Method to evict all queries that use the provided class as candidate.
void	evict(Query query)	Evict the query from the results cache.
void	evict(Query query, Map params)	Evict the query with the specified params from the results cache.
void	evictAll()	Method to clear the cache.
List<Object>	get(String queryKey)	Accessor for the results from the cache.
List<Object>	put(String queryKey, List<Object> results)	Method to put an object in the cache.

Methods inherited from class Object

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

Methods inherited from interface QueryResultsCache

isEmpty, pin, pin, size, unpin, unpin

Field Details

serialVersionUID

private static final long serialVersionUID

See Also:

• Constant Field Values

cache

private javax.cache.Cache cache

Constructor Details

JavaxCacheQueryResultCache

public JavaxCacheQueryResultCache(NucleusContext nucleusCtx)

Constructor.

Parameters:

nucleusCtx - Context

Method Details

close

public void close()

Description copied from interface: QueryResultsCache

Method to close the cache when no longer needed. Provides a hook to release resources etc.

contains

public boolean contains(String queryKey)

Description copied from interface: QueryResultsCache

Accessor for whether the specified query is in the cache

Parameters:

queryKey - The query key

Returns:

Whether it is in the cache

evict

public void evict(Class candidate)

Description copied from interface: QueryResultsCache

Method to evict all queries that use the provided class as candidate. This is usually called when an instance of the candidate has been changed in the datastore.

Parameters:

candidate - The candidate

evict

public void evict(Query query)

Description copied from interface: QueryResultsCache

Evict the query from the results cache.

Parameters:

query - The query to evict (evicts all use of this query, with any params)

evict

public void evict(Query query,
 Map params)

Description copied from interface: QueryResultsCache

Evict the query with the specified params from the results cache.

Parameters:

query - The query to evict

params - The parameters

evictAll

public void evictAll()

Description copied from interface: QueryResultsCache

Method to clear the cache.

get

public List<Object> get(String queryKey)

Description copied from interface: QueryResultsCache

Accessor for the results from the cache.

Parameters:

queryKey - The query key

Returns:

The cached query result ids

put

public List<Object> put(String queryKey,
 List<Object> results)

Description copied from interface: QueryResultsCache

Method to put an object in the cache.

Parameters:

queryKey - The query key

results - The results for this query

Returns:

The result ids previously associated with this query (if any)