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


Copyright © 2005-2006 Apache Software Foundation. All Rights Reserved.