retrieveParticipants()

関係インスタンスからゼロまたは複数の参加者を検索します。

構文

Participant[] retrieveParticipants(String relDefName,
        String partDefName, int instanceId)|
  
 Participant[] retrieveParticipants(String relDefName,
        String[] partDefList, int instanceId)
  
 Participant[] retrieveParticipants(String relDefName,
         int instanceId)
 

パラメーター

relDefName
関係定義の名前。

partDefName
参加者定義の名前。

partDefList
参加者定義のリスト。

instanceId
参加者が属する関係インスタンスの関係インスタンス ID。

戻り値

参加者インスタンスの配列を戻します。

例外

RelationshipRuntimeException 
 

注記

retrieveParticipants() メソッドは、アウトバウンド・マップで参照関係をインプリメントします。 このメソッドは、指定した instanceID 関係インスタンス ID に関連付けられた関係表から参加者インスタンスを取得します。relDefName 関係定義に関連付けられた属性のみ を検索します。ビジネス・オブジェクトの他の属性には、入力しません。関係定義に関連付けられた属性は通常、キー属性と、明示的に選択したその他の属性です。関係定義の詳細については、関係定義の作成を参照してください。

retrieveParticipants()RelationshipRuntimeException を生成すると、null 値の instanceId を受け取ります。retrieveInstances() メソッドが、一致するインスタンス ID を戻したかどうか保証できない場合は、retrieveParticipants() を呼び出す に、null 値について instanceId の値を検査してください。

retrieveParticipants() メソッドは、静的として宣言されたクラス・メソッドです。既存の関係インスタンスから、または Relationship クラスを参照することでこのメソッドを呼び出すことができます。

参照項目

addMyChildren(), deactivateParticipant(), deleteParticipant(), retrieveInstances()

"参照関係のマップ変換のカスタマイズ"

Copyright IBM Corp. 2004