Package 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
Nested ClassesModifier and TypeInterfaceDescriptionstatic class
This class is an empty implementation of the DataStoreCache interface. -
Method Summary
Modifier and TypeMethodDescriptionvoid
Evict the parameter instance from the second-level cache.void
evictAll()
Evict the parameter instances from the second-level cache.void
Evict the parameter instances from the second-level cache.void
Evict the parameter instances from the second-level cache.void
evictAll
(Collection oids) Evict the parameter instances from the second-level cache.void
Pin the parameter instance in the second-level cache.void
Pin instances in the second-level cache.void
Pin the parameter instances in the second-level cache.void
pinAll
(Collection oids) Pin the parameter instances in the second-level cache.void
Unpin the parameter instance from the second-level cache.void
Unpin instances from the second-level cache.void
Unpin the parameter instance from the second-level cache.void
unpinAll
(Collection oids) Unpin the parameter instances from the second-level cache.
-
Method Details
-
evict
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
Evict the parameter instances from the second-level cache.- Parameters:
oids
- the object ids of the instance to evict.- Since:
- 2.0
-
evictAll
Evict the parameter instances from the second-level cache.- Parameters:
oids
- the object ids of the instance to evict.- Since:
- 2.0
-
evictAll
Evict the parameter instances from the second-level cache.- Parameters:
subclasses
- if true, evict instances of subclasses alsopcClass
- the class of instances to evict- Since:
- 2.1
-
pin
Pin the parameter instance in the second-level cache. This is a hint only, and will be ignored if the underlying cache doesn't support it.- Parameters:
oid
- the object id of the instance to pin.- Since:
- 2.0
-
pinAll
Pin the parameter instances in the second-level cache. This is a hint only, and will be ignored if the underlying cache doesn't support it.- Parameters:
oids
- the object ids of the instances to pin.- Since:
- 2.0
-
pinAll
Pin the parameter instances in the second-level cache. This is a hint only, and will be ignored if the underlying cache doesn't support it.- Parameters:
oids
- the object ids of the instances to pin.- Since:
- 2.0
-
pinAll
Pin instances in the second-level cache. This is a hint only, and will be ignored if the underlying cache doesn't support it.- Parameters:
subclasses
- if true, pin instances of subclasses alsopcClass
- the class of instances to pin- Since:
- 2.1
-
unpin
Unpin the parameter instance from the second-level cache. This is a hint only, and will be ignored if the underlying cache doesn't support it.- Parameters:
oid
- the object id of the instance to unpin.- Since:
- 2.0
-
unpinAll
Unpin the parameter instances from the second-level cache. This is a hint only, and will be ignored if the underlying cache doesn't support it.- Parameters:
oids
- the object ids of the instance to evict.- Since:
- 2.0
-
unpinAll
Unpin the parameter instance from the second-level cache. This is a hint only, and will be ignored if the underlying cache doesn't support it.- Parameters:
oids
- the object id of the instance to evict.- Since:
- 2.0
-
unpinAll
Unpin instances from the second-level cache. This is a hint only, and will be ignored if the underlying cache doesn't support it.- Parameters:
subclasses
- if true, unpin instances of subclasses alsopcClass
- the class of instances to unpin- Since:
- 2.1
-