IBM Bank Transformation Toolkit Javadoc

com.ibm.btt.cha.ejb
Interface CHAInstanceLocal

All Superinterfaces:
javax.ejb.EJBLocalObject

public interface CHAInstanceLocal
extends javax.ejb.EJBLocalObject

Local interface for Enterprise Bean: CHAInstance


Field Summary
static java.lang.String COPYRIGHT
           
 
Method Summary
 void addElement(java.io.Serializable anElement)
          Adds an element to the Context
 void clearKeyedCollection()
          Clears the context (current level only) by destroying the current keyed collection associated and replacing it with a new one.
 void clearKeyedCollection(boolean keepKCollStatus, boolean clearOnlyValues)
          This method clears both the typed and non-typed elements in the context keyed collection.
 Vector fields()
          Returns all the data fields, which are addressable from this context.
 void forChainTo(java.lang.String parentInstanceID)
          Chains this context to the context named specified by parentInstanceID.
 void forUnchain()
          Removes this context and all its children from the context tree.
 java.lang.String getAncestorByName(java.lang.String aContextName)
          Searches the context tree for an ancestor Context named aContextName and returns the first matching context.
 byte[] getContext()
          Get accessor for persistent attribute: context
 java.lang.String getContextByType(java.lang.String aTypeName)
          Returns the instanceID of the first context that matches its type to aTypeName.
 java.io.Serializable getElementAt(java.lang.String aCompositeKey, boolean isReadOnly)
          Returns the element of its keyedCollection,or keyedCollections of the upper contexts which is located at aCompositeKey path.
 javax.ejb.EntityContext getEntityContext()
          getEntityContext
 java.lang.String getInstanceID()
          Get accessor for persistent attribute: instanceID
 boolean getIsRoot()
          Get accessor for persistent attribute: isRoot
 KeyedCollection getKeyedCollection()
          Returns the keyedCollection attribute.
 java.lang.String getLevel()
          We can define an attribute --level-- in dsectxt.xml file to indicate level of the context.
 java.lang.String getName()
          Get accessor for persistent attribute: name
 java.lang.String getParentID()
          Get accessor for persistent attribute: parentID
 Context getRealContext()
          Returns the _context.
 java.lang.String getTypeName()
          Get accessor for persistent attribute: typeName
 boolean isAddToDynamicKColl()
          Returns the value of the addToDynamicKColl property.
 boolean isChained()
          return true/false based on the existence of a parent ID
 boolean isReadOnly()
          If the definition of this context in dsetxt.xml has the attribute readonly="true", this method will return true, otherwise, false is returned.
 DataElement removeAt(java.lang.String aCompositeKey)
          Removes aCompositeKey element of its keyedCollection.
 DataElement removeAtAnyLevel(java.lang.String aCompositeKey)
          Removes an element of its keyedCollection, or the keyedCollections in the upper contexts, located in the aCompositeKey path.
 void setAddToDynamicKColl(boolean newValue)
          Sets the value of the addToDynamicKColl property.
 void setContext(byte[] newContext)
          Set accessor for persistent attribute: context
 void setInstanceID(java.lang.String newInstanceID)
          Set accessor for persistent attribute: instanceID
 void setIsRoot(boolean newIsRoot)
          Set accessor for persistent attribute: isRoot
 void setKCollDynamic(boolean aValue)
          Set the value to the attribute dynamic for the keyedCollection in this context.
 void setKeyedCollection(java.io.Serializable akeyedCollection)
          set the context's KeyedCollection.
 void setName(java.lang.String newName)
          Set accessor for persistent attribute: name
 void setParentID(java.lang.String newParentID)
          Set accessor for persistent attribute: parentID
 void setRealContext(Context context)
          Sets the _context.
 void setTypeName(java.lang.String newTypeName)
          Set accessor for persistent attribute: typeName
 int setValueAt(SortedTable aSortedTable)
          The function is similiar to setValueAt(String, Object) except that set pairs of keys and values stored in aSortedTable via one method.
 void setValueAt(java.lang.String aKey, java.io.Serializable aValue)
          Adds a value to the Context
 Vector toStrings()
          Returns a visual representation of this context.
 int trySetElementAt(java.lang.String aCompositeKey, java.io.Serializable aValue)
          Set the value of the element of its keyedCollection, or keyedCollections of the upper contexts which is located at aCompositeKey path.
 
Methods inherited from interface javax.ejb.EJBLocalObject
getEJBLocalHome, getPrimaryKey, isIdentical, remove
 

Field Detail

COPYRIGHT

static final java.lang.String COPYRIGHT
See Also:
Constant Field Values
Method Detail

setName

void setName(java.lang.String newName)
Set accessor for persistent attribute: name


setParentID

void setParentID(java.lang.String newParentID)
Set accessor for persistent attribute: parentID


setContext

void setContext(byte[] newContext)
Set accessor for persistent attribute: context


setInstanceID

void setInstanceID(java.lang.String newInstanceID)
Set accessor for persistent attribute: instanceID


setKeyedCollection

void setKeyedCollection(java.io.Serializable akeyedCollection)
                        throws CHAPersistenceException
set the context's KeyedCollection. Warning: parameter value can be large. Also any existing keyedCollection in the Context object is immediately replaced.

Throws:
CHAPersistenceException

setValueAt

void setValueAt(java.lang.String aKey,
                java.io.Serializable aValue)
                throws CHAPersistenceException
Adds a value to the Context

Throws:
CHAPersistenceException

addElement

void addElement(java.io.Serializable anElement)
                throws CHAPersistenceException
Adds an element to the Context

Throws:
CHAPersistenceException

clearKeyedCollection

void clearKeyedCollection()
                          throws CHAPersistenceException
Clears the context (current level only) by destroying the current keyed collection associated and replacing it with a new one.

Throws:
CHAPersistenceException

clearKeyedCollection

void clearKeyedCollection(boolean keepKCollStatus,
                          boolean clearOnlyValues)
                          throws CHAPersistenceException
This method clears both the typed and non-typed elements in the context keyed collection. It can clear only the elements of the kColl and keep the kColl attributes. For the kColl elements it is possible to clear only the values or to clear all the attributes.

Parameters:
keepKCollStatus - boolean (false - clear also the context kColl attributes; true - keep the context kColl attributes and clear only the kColl data elements)
clearOnlyValues - boolean (false - clear all attributes of the context kColl data elements; true - clear only kColl data elements values)
Throws:
IOException - - If keepKCollStatus or clearOnlyValues are false and the keyed collection has not been defined in the generic data file or in the generic types file
CHAPersistenceException

getContext

byte[] getContext()
Get accessor for persistent attribute: context


getEntityContext

javax.ejb.EntityContext getEntityContext()
getEntityContext


getInstanceID

java.lang.String getInstanceID()
Get accessor for persistent attribute: instanceID


getName

java.lang.String getName()
Get accessor for persistent attribute: name


getParentID

java.lang.String getParentID()
Get accessor for persistent attribute: parentID


isChained

boolean isChained()
return true/false based on the existence of a parent ID


getRealContext

Context getRealContext()
Returns the _context.

Returns:
com.ibm.btt.base.Context

setRealContext

void setRealContext(Context context)
Sets the _context.


getKeyedCollection

KeyedCollection getKeyedCollection()
                                   throws CHAPersistenceException
Returns the keyedCollection attribute.

Throws:
CHAPersistenceException

fields

Vector fields()
              throws CHAPersistenceException
Returns all the data fields, which are addressable from this context. This includes all the data fields of this context and the upper context.

Returns:
Vector
Throws:
CHAPersistenceException

getAncestorByName

java.lang.String getAncestorByName(java.lang.String aContextName)
                                   throws CHAPersistenceException
Searches the context tree for an ancestor Context named aContextName and returns the first matching context.

Parameters:
aContextName - java.lang.String
Returns:
String instanceID
Throws:
CHAPersistenceException

getContextByType

java.lang.String getContextByType(java.lang.String aTypeName)
                                  throws CHAPersistenceException
Returns the instanceID of the first context that matches its type to aTypeName.

Throws:
CHAPersistenceException

removeAt

DataElement removeAt(java.lang.String aCompositeKey)
                     throws CHAPersistenceException
Removes aCompositeKey element of its keyedCollection.

Throws:
CHAPersistenceException

removeAtAnyLevel

DataElement removeAtAnyLevel(java.lang.String aCompositeKey)
                             throws CHAPersistenceException
Removes an element of its keyedCollection, or the keyedCollections in the upper contexts, located in the aCompositeKey path.

Throws:
CHAPersistenceException

trySetElementAt

int trySetElementAt(java.lang.String aCompositeKey,
                    java.io.Serializable aValue)
                    throws CHAPersistenceException
Set the value of the element of its keyedCollection, or keyedCollections of the upper contexts which is located at aCompositeKey path.

Throws:
CHAPersistenceException

setValueAt

int setValueAt(SortedTable aSortedTable)
The function is similiar to setValueAt(String, Object) except that set pairs of keys and values stored in aSortedTable via one method. Behind this method, when this context is a distributed context, the pairs of keys and values stored in aSortedTable will be sent to CHA server a time, thus improving performance.

Parameters:
aSortedTable -
Returns:
int = 0 : success int = 1,2,...,n: a value is failed to set which is indicated by return int value. For example, if return value is 1, the first value in aSortedTable can not be set successfully. if return value is 2, the first value is set successfully, but the second value is failed to be set and subsequent pairs of the keys and values will not be set .

isReadOnly

boolean isReadOnly()
                   throws CHAPersistenceException
If the definition of this context in dsetxt.xml has the attribute readonly="true", this method will return true, otherwise, false is returned.

Returns:
boolean
Throws:
CHAPersistenceException

getElementAt

java.io.Serializable getElementAt(java.lang.String aCompositeKey,
                                  boolean isReadOnly)
                                  throws CHAPersistenceException
Returns the element of its keyedCollection,or keyedCollections of the upper contexts which is located at aCompositeKey path.

Throws:
CHAPersistenceException

isAddToDynamicKColl

boolean isAddToDynamicKColl()
                            throws CHAPersistenceException
Returns the value of the addToDynamicKColl property.

Returns:
boolean - The current value of addToDynamicKColl
Throws:
CHAPersistenceException

setAddToDynamicKColl

void setAddToDynamicKColl(boolean newValue)
                          throws CHAPersistenceException
Sets the value of the addToDynamicKColl property.

Parameters:
newValue - boolean The new value of the property.
Throws:
CHAPersistenceException

setKCollDynamic

void setKCollDynamic(boolean aValue)
                     throws CHAPersistenceException
Set the value to the attribute dynamic for the keyedCollection in this context.

Parameters:
aValue -
Throws:
CHAPersistenceException

toStrings

Vector toStrings()
Returns a visual representation of this context.

Returns:
Vector

getTypeName

java.lang.String getTypeName()
Get accessor for persistent attribute: typeName


setTypeName

void setTypeName(java.lang.String newTypeName)
Set accessor for persistent attribute: typeName


getIsRoot

boolean getIsRoot()
Get accessor for persistent attribute: isRoot


setIsRoot

void setIsRoot(boolean newIsRoot)
Set accessor for persistent attribute: isRoot


getLevel

java.lang.String getLevel()
                          throws CHAPersistenceException
We can define an attribute --level-- in dsectxt.xml file to indicate level of the context. The context can be devided into three levels:root, session, normal.

Returns:
"root", "session", "normal". If this attribute is not difined, return null ;
Throws:
CHAPersistenceException

forChainTo

void forChainTo(java.lang.String parentInstanceID)
                throws CHAPersistenceException
Chains this context to the context named specified by parentInstanceID. This method throws an CHAPersistenceException if this context does not exist.

Throws:
CHAPersistenceException

forUnchain

void forUnchain()
                throws CHAPersistenceException
Removes this context and all its children from the context tree. Also maintains the consistency of the context tree.

Throws:
CHAPersistenceException

IBM Bank Transformation Toolkit Javadoc

(c) Copyright IBM Corporation 1998, 2008