javax.jdo.datastore
Interface DataStoreCache

All Known Implementing Classes:

DataStoreCache.EmptyDataStoreCache

public interface DataStoreCache

Many JDO implementations allow instances to be cached in a second-level cache, and allow direct management of the cache by knowledgeable applications. This interface standardizes this behavior.

Since:

2.0

Version:

2.0

Nested Class Summary

static class

DataStoreCache.EmptyDataStoreCache This class is an empty implementation of the DataStoreCache interface.

Method Summary

void	evict(java.lang.Object oid) Evict the parameter instance from the second-level cache.
void	evictAll() Evict the parameter instances from the second-level cache.
void	evictAll(java.lang.Class pcClass, boolean subclasses) Evict the parameter instances from the second-level cache.
void	evictAll(java.util.Collection oids) Evict the parameter instances from the second-level cache.
void	evictAll(java.lang.Object[] oids) Evict the parameter instances from the second-level cache.
void	pin(java.lang.Object oid) Pin the parameter instance in the second-level cache.
void	pinAll(java.lang.Class pcClass, boolean subclasses) Pin instances in the second-level cache.
void	pinAll(java.util.Collection oids) Pin the parameter instances in the second-level cache.
void	pinAll(java.lang.Object[] oids) Pin the parameter instances in the second-level cache.
void	unpin(java.lang.Object oid) Unpin the parameter instance from the second-level cache.
void	unpinAll(java.lang.Class pcClass, boolean subclasses) Unpin instances from the second-level cache.
void	unpinAll(java.util.Collection oids) Unpin the parameter instances from the second-level cache.
void	unpinAll(java.lang.Object[] oids) Unpin the parameter instance from the second-level cache.

Method Detail

evict

void evict(java.lang.Object oid)

Evict the parameter instance from the second-level cache.

Parameters:

oid - the object id of the instance to evict.

Since:

2.0

evictAll

void evictAll()

Evict the parameter instances from the second-level cache. All instances in the PersistenceManager's cache are evicted from the second-level cache.

Since:

2.0

evictAll

void evictAll(java.lang.Object[] oids)

Evict the parameter instances from the second-level cache.

Parameters:

oids - the object ids of the instance to evict.

Since:

2.0

evictAll

void evictAll(java.util.Collection oids)

Evict the parameter instances from the second-level cache.

Parameters:

oids - the object ids of the instance to evict.

Since:

2.0

evictAll

void evictAll(java.lang.Class pcClass,
              boolean subclasses)

Evict the parameter instances from the second-level cache.

Parameters:

pcClass - the class of instances to evict

subclasses - if true, evict instances of subclasses also

Since:

2.0

pin

void pin(java.lang.Object oid)

Pin the parameter instance in the second-level cache.

Parameters:

oid - the object id of the instance to pin.

Since:

2.0

pinAll

void pinAll(java.util.Collection oids)

Pin the parameter instances in the second-level cache.

Parameters:

oids - the object ids of the instances to pin.

Since:

2.0

pinAll

void pinAll(java.lang.Object[] oids)

Pin the parameter instances in the second-level cache.

Parameters:

oids - the object ids of the instances to pin.

Since:

2.0

pinAll

void pinAll(java.lang.Class pcClass,
            boolean subclasses)

Pin instances in the second-level cache.

Parameters:

pcClass - the class of instances to pin

subclasses - if true, pin instances of subclasses also

Since:

2.0

unpin

void unpin(java.lang.Object oid)

Unpin the parameter instance from the second-level cache.

Parameters:

oid - the object id of the instance to unpin.

Since:

2.0

unpinAll

void unpinAll(java.util.Collection oids)

Unpin the parameter instances from the second-level cache.

Parameters:

oids - the object ids of the instance to evict.

Since:

2.0

unpinAll

void unpinAll(java.lang.Object[] oids)

Unpin the parameter instance from the second-level cache.

Parameters:

oids - the object id of the instance to evict.

Since:

2.0

unpinAll

void unpinAll(java.lang.Class pcClass,
              boolean subclasses)

Unpin instances from the second-level cache.

Parameters:

pcClass - the class of instances to unpin

subclasses - if true, unpin instances of subclasses also

Since:

2.0