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

Interface COM.ibm.jaws.services.bcfw.BaseCollectionDel

public interface BaseCollectionDel
extends Object
extends BaseCollection
A delegating BaseCollection (BaseCollectionDel) is a BaseCollection that implements each Managed object as two objects at runtime with separate classes.

The AA produces a Cached version of the Manageable class that contains the services-enhanced implementation of the application-specific methods.

The AA produces a Managed version of the Manageable class that implements the Managed interface for a particular BC, and delegates the other methods to the Cached object. The Cached object may itself be either a single object (the Cached class also supports the CacheEntry interface) or two objects (a generic CacheEntry object references the Cache object). The AA is aided in building these by a template supplied by the SP for that BaseCollectionDel. Instances of the Managed and Cached classes are the runtime objects of the BaseCollectionDel.


Method Index

 o exists(String)
This tests whether the key corresponds to an existing Managed object within this BaseCollectionDel.
 o kill(String)
BaseCollectionEC adds the method (kill) that allows its Managed object to notify it when one of the BaseCollectionDel's ApplicationObject's is being removed.
 o reattachManagedDel(ManagedDel, String)
BaseCollectionEC adds the method reattachMO() that allows its Managed object to notify it when the Managed object needs to be reattached to the BaseCollectionDel's Cached object identified by the key parameter.
 o syncManaged(String)
This method allows a ManagedDel to tell the BaseCollectionDel to write the EssentialData of the Managed object identified by the key to it persistent storage if it is dirty.

Methods

 o kill
  public abstract void kill(String key) throws InvalidReferenceException
BaseCollectionEC adds the method (kill) that allows its Managed object to notify it when one of the BaseCollectionDel's ApplicationObject's is being removed.
Parameters:
key - is the String Identifier relative to the target BaseCollectionDel that identifies which Managed object is to be removed.
Throws: InvalidReferenceException
indicates that the Managed object was removed.
 o reattachManagedDel
  public abstract CacheEntry reattachManagedDel(ManagedDel managedDel,
                                                String key) throws InvalidReferenceException
BaseCollectionEC adds the method reattachMO() that allows its Managed object to notify it when the Managed object needs to be reattached to the BaseCollectionDel's Cached object identified by the key parameter.
Parameters:
managedDel - is the calling ManagedDel object that wants to be reattached to a CacheEntry.
key - is the String Identifier relative to the target BaseCollectionDel that identifies which Managed object needs to be cached.
Returns:
is the requested CacheEntry if the Cached object could be cached, or null if it could not if for any other reason that than that the object was removed.
Throws: InvalidReferenceException
indicates that the Managed object was removed.
 o exists
  public abstract boolean exists(String key)
This tests whether the key corresponds to an existing Managed object within this BaseCollectionDel. Even though reattachMO would work for this function, this special case can determine existence without activating the object.
Parameters:
key - is the String Identifier key that indicates which Managed object to test for.
Returns:
is a boolean indicating whether there exists a Managed object with the specified key.
 o syncManaged
  public abstract void syncManaged(String key)
This method allows a ManagedDel to tell the BaseCollectionDel to write the EssentialData of the Managed object identified by the key to it persistent storage if it is dirty.
Parameters:
key - is the String Identifier key that indicates which Managed object to sync.

All Packages  Class Hierarchy  This Package  Previous  Next  Index