updateMyChildren()

必要に応じて、一致関係の指定された親/子関係で子インスタンスを追加または削除します。

構文

void updateMyChildren(String parentChildRelDefName, 
       String parentParticpntDef, BusObj parentBusObj,
       String childParticpntDef, String childAttrName,
       String childIdentityRelDefName, 
       String childIdentityParticpntDefName,
       CxExecutionContext map_ctx)
 

パラメーター

parentChildRelDefName
親/子関係定義の名前。

parentParticpntDefName
親/子関係で親ビジネス・オブジェクトを表す参加者定義の名前。

parentBusObj
親ビジネス・オブジェクトを含む変数。

childParticpntDefName
親/子関係で子ビジネス・オブジェクトを表す参加者定義の名前。

childAttrName
親ビジネス・オブジェクトの属性の名前。親ビジネス・オブジェクトのタイプは、親/子関係に参加する子オブジェクトの名前です。例えば、顧客と住所の関係で、親オブジェクトに Address1 属性が含まれ、この属性がタイプ Address の子ビジネス・オブジェクトである場合、childAttrName 属性名は Address1 になります。

childIdentityRelDefName
子ビジネス・オブジェクトが参加する一致関係の名前。

childIdentityParticpntDefName
一致関係で子ビジネス・オブジェクトを表す参加者定義の名前。

map_ctx
マップの実行コンテキスト。マップの実行コンテキストを渡すには、cwExecCtx 変数を使用します。この変数は、Map Designer Express によってすべてのマップに定義されます。

戻り値

なし。

例外

RelationshipRuntimeException
この例外がスローされた場合の詳細については、『注記』セクションを参照してください。

注記

updateMyChildren() メソッドは、parentChildRelDefNamechildIdentityRelDefName 関係定義の関係表の子インスタンスを更新します。このメソッドは、親ビジネス・オブジェクトが子オブジェクトの追加または除去によって更新された場合の一致関係で有効です。updateMyChildren() を使用して、変更後イメージ (parentBusObj にあります) と変更前イメージ (関係表の情報) を比較し、変更後イメージで新しい、または削除された子オブジェクトを判別します。

注:
updateMyChildren() メソッドは、子の複合キーが祖父母に依存する場合を処理 できません。詳細については、"Update My Children の使用についてのヒント"を参照してください。

updateMyChildren() メソッドは、渡された引き数で以下の検証を実行します。

上記の検証のいずれかが失敗した場合、updateMyChildren()RelationshipRuntimeException 例外をスローします。

引き数の検証が完了すると、updateMyChildren() メソッドは、必要に応じて、指定した親ビジネス・オブジェクトに属する子ビジネス・オブジェクトのリストに子を追加、または子を削除します。このメソッドは、親および子の参加者 (parentParticpntDefNamechildParticpntDefName) の関係表に対して、次のタスクのいずれかを実行します。

updateMyChildren() メソッドでは、Relationship Designer Express で定義された親/子関係が必要です。この種類の関係を作成する方法の詳細については、"親/子関係定義の作成"を参照してください。

注:
子ビジネス・オブジェクトに固有キーがある場合、子の参加者の属性は、子オブジェクトの固有キーになります。子オブジェクトに固有キーがない場合、子の参加者の属性はこの非固有キーになります。

updateMyChildren()maintainCompositeRelationship() メソッドを含む例については、maintainCompositeRelationship() の『例』セクションを参照してください。

updateMyChildren() を含む例については、"複合一致関係に関連するマップの規則のカスタマイズ"を参照してください。

参照項目

addMyChildren(), deleteMyChildren(), maintainCompositeRelationship(), maintainSimpleIdentityRelationship()

"親ビジネス・オブジェクトに対する更新処理"

Copyright IBM Corp. 2004