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"
