|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
This interface is the functional (applicative) view for the Caching Service. All accesses to the cache are made through the Cache instance provided to the applicative level. The primary purpose of the caching service is to improve the overall system performance. The performance gain is from avoidance of costs due to I/O operations related to storage/network devices, recreation-related costs, etc. This service is to be used by several services such as the persistence service and the replication service, among others.
Method Summary | |
CacheEntry |
bind(java.lang.Object id,
java.lang.Object object)
This method allows a in-memory object (incarnation) to be placed in the cache. |
void |
fix(CacheEntry ce)
This method notifies the cache manager the intention to use the object identified by lid. |
CacheEntry |
lookup(java.lang.Object id)
This method searches the object, identified by lid, within the cache. |
void |
touch(CacheEntry entry)
Called whenever an object has been accessed. |
void |
unfix(CacheEntry ce)
This method is used to notify the cache manager that the object identified by lid is not longer to be used. |
Method Detail |
public CacheEntry bind(java.lang.Object id, java.lang.Object object) throws CacheException
id
- The corresponding object identifier.
(It must be generated elsewhere, e.g. by a naming
service).object
- The object to be cached.
CacheException
- If object/lid are already registered
or either object or lid are null.public CacheEntry lookup(java.lang.Object id)
id
- The corresponding object identifier.
public void fix(CacheEntry ce) throws CacheException
ce
-
CacheException
- If the object is not in the cache.public void unfix(CacheEntry ce) throws CacheException
ce
-
CacheException
- If the object has not been previously fixed.public void touch(CacheEntry entry) throws CacheException
entry
- The cache entry that has been accessed.
CacheException
- Whenever an internal error occurs.
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |