Sets the
child business object
verb based on the map execution context and the verb of the parent business
object.
Syntax
public static void maintainChildVerb (String relDefName,
String appSpecificParticpntName,
String genericParticpntName,
BusObj appSpecificObj,
String appSpecificChildObj,
BusObj genericObj,
String genericChildObj,
CxExecutionContext map_ctx,
boolean to_Retrieve,
boolean is_Composite)
Parameters
- relDefName
- The name of the identity relationship name that manages the child business
object.
- appSpecificParticpntName
- The name of the application-specific participant definition.
- genericParticpntName
- The name of the generic participant definition.
- appSpecificObj
- The application-specific object that contains the child object.
- appSpecificChildObj
- The name of the application child business object.
- genericObj
- The generic business object to or from which the
appSpecificObject is being mapped.
- genericChildObj
- The name of the generic child business object.
- ctx
- The execution context.
- to_Retrieve
- The flag for the SERVICE_CALL_RESPONSE logic. When the condition is
true, update the verbs of the child business objects. If false, do
nothing.
- isComposite
- The flag that indicates whether the child participant uses composite
keys. If the condition is true, keys are used; if false, keys are
not used.
Return values
None.
Exceptions
RelationshipRuntimeException--see the Notes section for
more information on when this exception is thrown
ClassCastException
Notes
The maintainChildVerb() method performs the following
validations on arguments that are passed in:
- Validate the name of the relDefName relationship
definition.
- Validate the name of the participant definitions for the
application-specific business object
(appSpecificParticpntName) and the generic business
object (genericParticpntName).
- Make sure that the application-specific
(appSpecificObject) and generic business objects
(genericObject) are not null.
- Make sure that the relDefName relationship is an
identity relationship. In addition, the participant definition in
relDefName that represents the generic business object
must be defined as IBM WebSphere InterChange Server
Express-managed. For more information on how to specify these
settings, see "Defining identity relationships".
If any of these validations fails, maintainChildVerb() throws
the RelationshipRuntimeException exception.
Once the arguments are validated, the action that
maintainChildVerb() takes depends on the following
information:
- The calling context--in the map execution context, passed in as part
of the map_ctx argument (cwExecCtx)
- The verb--in the source business object
- Application-specific business object
(appSpecificObj) for calling contexts
EVENT_DELIVERY (or
ACCESS_REQUEST) and
SERVICE_CALL_RESPONSE
- Generic business object (genericObj) for calling
context
SERVICE_CALL_REQUEST
For more information on the actions that maintainChildVerb()
takes, see "Determining the child verb setting". Table 84 through Table 87 provide the actions for each
of the calling contexts.
You call this method in the transformation step for the child attribute of
a parent object. This child object can participant in either
- In the transformation step for the key attribute of a submap that
transforms child business objects if the child business objects are related
using a unique key.
You usually use maintainChildVerb() to set the verb of a child
object that participates in a composite identity relationship
(maintainCompositeRelationship()). However, you can also
call it to set the verb of a child object that participates in a simple
identity relationship
(maintainSimpleIdentityRelationship()).
Examples
For an example involving maintainChildVerb(), see "Customizing map rules for a composite identity relationship".
See also
maintainCompositeRelationship(), maintainSimpleIdentityRelationship()
"Setting the source child verb"
