マップの実行コンテキストと、親ビジネス・オブジェクトの動詞に基づいて、子ビジネス・オブジェクトの動詞を設定します。
構文
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)
パラメーター
- relDefName
- 子ビジネス・オブジェクトを管理する一致関係名の名前。
- appSpecificParticpntName
- アプリケーション固有の参加者定義の名前。
- genericParticpntName
- 汎用的な参加者定義の名前。
- appSpecificObj
- 子オブジェクトを含む、アプリケーション固有のオブジェクト。
- appSpecificChildObj
- アプリケーションの子ビジネス・オブジェクトの名前。
- genericObj
- appSpecificObject
のマップ先、またはマップ元の汎用ビジネス・オブジェクト。
- genericChildObj
- 汎用子ビジネス・オブジェクトの名前。
- ctx
- 実行コンテキスト。
- to_Retrieve
- SERVICE_CALL_RESPONSE ロジックのフラグ。条件が true
の場合は、子ビジネス・オブジェクトの動詞を更新します。false
の場合は何もしません。
- isComposite
- 子の参加者が複合キーを使用するかどうかを示すフラグ。条件が true
の場合、キーが使用されます。false 場合、キーは使用されません。
戻り値
なし。
例外
RelationshipRuntimeException --
この例外がスローされた場合の詳細については、『注記』セクションを参照してください。
ClassCastException
注記
maintainChildVerb()
メソッドは、渡された引き数で以下の検証を実行します。
- relDefName 関係定義の名前を検証します。
- アプリケーション固有のビジネス・オブジェクト
(appSpecificParticpntName) と汎用ビジネス・オブジェクト
(genericParticpntName) の参加者定義の名前を検証します。
- アプリケーション固有のビジネス・オブジェクト
(appSpecificObject) と汎用ビジネス・オブジェクト
(genericObject) が null でない
ことを確認します。
- relDefName
関係が一致関係であることを確認します。また、汎用ビジネス・オブジェクトを表す
relDefName の参加者定義は、IBM WebSphere Business
Integration Server Express
管理対象として定義される必要があります。これらの設定を指定する方法の詳細については、"一致関係の定義"を参照してください。
上記の検証のいずれかが失敗した場合、maintainChildVerb() は
RelationshipRuntimeException 例外をスローします。
引き数の検証が完了すると、maintainChildVerb()
が実行するアクションは、次の情報によって異なります。
- 呼び出しコンテキスト --
マップの実行コンテキストでは、map_ctx 引き数
(cwExecCtx) の一部として渡されます。
- 動詞 -- ソース・ビジネス・オブジェクトの場合:
- 呼び出しコンテキスト EVENT_DELIVERY (または
ACCESS_REQUEST) と SERVICE_CALL_RESPONSE
のアプリケーション固有のビジネス・オブジェクト
(appSpecificObj)
- 呼び出しコンテキスト SERVICE_CALL_REQUEST
の汎用ビジネス・オブジェクト (genericObj)
maintainChildVerb() が行うアクションの詳細については、"子動詞設定の決定"を参照してください。表 105 から表 108
に、各呼び出しコンテキストのアクションを示します。
親オブジェクトの子属性に対する変換ステップで、このメソッドを呼び出すことができます。この子オブジェクトは、次のいずれかに参加できます。
- 子ビジネス・オブジェクトが固有キーを使用して関連している場合は、子ビジネス・オブジェクトを変換するサブマップのキー属性に対する変換ステップ。
通常は maintainChildVerb() を使用して、複合一致関係
(maintainCompositeRelationship())
に参加する子オブジェクトの動詞を設定します。ただし、単純一致関係
(maintainSimpleIdentityRelationship())
に参加する子オブジェクトの動詞を設定して呼び出すこともできます。
例
maintainChildVerb() を含める例については、"複合一致関係に関連するマップの規則のカスタマイズ"を参照してください。
参照項目
maintainCompositeRelationship(), maintainSimpleIdentityRelationship()
"ソース子動詞の設定"
