Interface COM.ibm.jaws.services.bcfw.BaseCollectionEC
All Packages  Class Hierarchy  This Package  Previous  Next  Index

Interface COM.ibm.jaws.services.bcfw.BaseCollectionEC

public interface BaseCollectionEC
extends Object
extends BaseCollectionDel
A BaseCollectionEC is a BaseCollectionDel that can interact with an external CacheManager, which can be shared across multiple BaseCollectionEC's. This larger scope of sharing allows cache space resources to be used by the most active Cached objects, regardless of which BaseCollectionEC's they are managed by.

A BaseCollectionEC must be aware that it is using an external CacheManager. The CacheManager is an initialization input parameter to these BaseCollectionEC's. The BaseCollectionEC calls the CacheManager using the CacheManager interface. The CacheManager calls the BaseCollectionEC with the interface described here to notify the BaseCollectionEC that one of its Cached object's is being discarded from the cache.

The CacheManager creates a CacheEntry to represent the Cached object in interactions with BaseCollectionEC's and to store public and private information about the Cached object's cache status. Depending on the BC, this CacheEntry interface can be supported directly by the Cached version of the Manageable class or it can be a separate object at runtime.

A BaseCollectionEC has the following standard dependency:

   - binding name=MOFW::cacheManager
   - interfaceName=COM.ibm.jaws.services.bcfw.CacheManager
That is, any BaseCollectionEC can find its cache manager object via
    CacheManager rootBC = 
                  (CacheManager)dependentContext.resolve(
                           "MOFW::cacheManager", 
                           "COM.ibm.jaws.services.bcfw.CacheManager"); 

Method Index

 o getCacheManager()
 o getTransientIdentifier()
Return the real object this proxy represents.
 o setCacheManager(CacheManager)
These methods allow the cache manager to be set/get.
 o uncached(CacheEntry)
This method allows the BaseCollectionEC's CacheManager to notify it when one of the BaseCollectionEC's Cached object's is discarded from the cache because it no longer satisfies the CacheManager's access pattern requirements, or when the BaseCollectionEC requested from the CacheManager to uncache one or more Cached objects.

Methods

 o uncached
  public abstract void uncached(CacheEntry uncachedEntry)
This method allows the BaseCollectionEC's CacheManager to notify it when one of the BaseCollectionEC's Cached object's is discarded from the cache because it no longer satisfies the CacheManager's access pattern requirements, or when the BaseCollectionEC requested from the CacheManager to uncache one or more Cached objects. A CacheEntry is represents an active Cached object, and stored in the CacheManager while the Cached object is cached.
Parameters:
uncachedEntry - is the CacheEntry that has been discarded from the cache.
 o setCacheManager
  public abstract void setCacheManager(CacheManager cacheManager)
These methods allow the cache manager to be set/get.
 o getCacheManager
  public abstract CacheManager getCacheManager()
 o getTransientIdentifier
  public abstract Object getTransientIdentifier()
Return the real object this proxy represents. This is used by the CacheManager to get a single id for the base collection containing the managed objects.

All Packages  Class Hierarchy  This Package  Previous  Next  Index