void updateMyChildren(String parentChildRelDefName, String parentParticpntDef, BusObj parentBusObj, String childParticpntDef, String childAttrName, String childIdentityRelDefName, String childIdentityParticpntDefName, CxExecutionContext map_ctx)
None.
The updateMyChildren() method updates the child instances in the relationship tables of the parentChildRelDefName and childIdentityRelDefName relationship definitions. This method is useful in an identity relationship when a parent business object has been updated as a result of the addition or removal of child objects. Use updateMyChildren() to compare the after-image (in parentBusObj) with the before-image (information in the relationship tables) to determine which child objects in the after-image are new or deleted.
The updateMyChildren() method performs the following validations on arguments that are passed in:
If any of these validations fails, updateMyChildren() throws the RelationshipRuntimeException exception.
Once the arguments are validated, the updateMyChildren() method adds children or deletes children from the list of child business objects that belong to the specified parent business object as appropriate. This method performs one of the following tasks to the relationship tables for the parent and child participants (parentParticpntDefName and childParticpntDefName, respectively):
This method does not add to the child's relationship table because all the business objects that are currently associated with the parent object have already been maintained when maintainCompositeRelationship() was called.
This method removes from the child's cross-reference table in addition to the parent/child relationship table.
The updateMyChildren() method requires that a parent/child relationship is defined with Relationship Designer Express. For information on how to create this kind of relationship, see Creating the parent/child relationship definition.
For an example involving updateMyChildren() in conjunction with the maintainCompositeRelationship() method, see the Examples section of maintainCompositeRelationship().
For more examples involving updateMyChildren(), see Customizing map rules for a composite identity relationship.