public interface ChildRelation extends Collection
ChildRelationinterface is used by SBBs that require child relationships with other SBBs. Any child-relation accessor method defined in an SBB abstract class must have this interface as its return type.
ChildRelation object, and any
obtained from it, are only valid within the transaction in which they materialized.
ChildRelation object conforms to the Java Collections API with the
java.lang.UnsupportedOperationExceptionif an attempt is made to modify the collection. The
createmethod should be used instead to add child SBB entities to the collection.
retainAllmethod call on a
ChildRelationobject, or by a
removemethod call on a
java.util.Iteratorobject obtained from a
ChildRelationobject, a cascade delete of the SBB entity tree rooted at the removed SBB entity is initiated. This means that removing an SBB entity from a
ChildRelationcollection has the same behavior as if the
removemethod was invoked on the removed SBB entity itself.
|Modifier and Type||Method and Description|
Create a new SBB entity of the SBB type associated with the relation.
SbbLocalObject create() throws CreateException, TransactionRequiredLocalException, SLEEException
This method is a mandatory transactional method.
CreateException- if an SBB entity could not be created. This exception may have propagated from the SBB object's
Sbb.sbbPostCreate(), or may have been thrown by the SLEE.
TransactionRequiredLocalException- if this method is invoked without a valid transaction context.
SLEEException- if the child SBB could not be created due to a system-level failure.