|
|||||||||||
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. |
void |
fix(CacheEntryFilter cef)
This method notifies the cache manager the intention to use objects in the cache. |
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. |
void |
unfix(CacheEntryFilter cef)
This method is used to notify the cache manager that objects are 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 fix(CacheEntryFilter cef) throws CacheException
cef
-
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 unfix(CacheEntryFilter cef) throws CacheException
cef
- indicates which instances have to be unfixed among entries
in the cache.
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 |