構文
Participant[] retrieveParticipants(String relDefName, String partDefName, int instanceId)| Participant[] retrieveParticipants(String relDefName, String[] partDefList, int instanceId) Participant[] retrieveParticipants(String relDefName, int instanceId)
パラメーター
戻り値
参加者インスタンスの配列を戻します。
例外
RelationshipRuntimeException
注記
retrieveParticipants() メソッドは、アウトバウンド・マップで参照関係をインプリメントします。 このメソッドは、指定した instanceID 関係インスタンス ID に関連付けられた関係表から参加者インスタンスを取得します。relDefName 関係定義に関連付けられた属性のみ を検索します。ビジネス・オブジェクトの他の属性には、入力しません。関係定義に関連付けられた属性は通常、キー属性と、明示的に選択したその他の属性です。関係定義の詳細については、関係定義の作成を参照してください。
retrieveParticipants() が RelationshipRuntimeException を生成すると、null 値の instanceId を受け取ります。retrieveInstances() メソッドが、一致するインスタンス ID を戻したかどうか保証できない場合は、retrieveParticipants() を呼び出す前 に、null 値について instanceId の値を検査してください。
retrieveParticipants() メソッドは、静的として宣言されたクラス・メソッドです。既存の関係インスタンスから、または Relationship クラスを参照することでこのメソッドを呼び出すことができます。
参照項目
addMyChildren(), deactivateParticipant(), deleteParticipant(), retrieveInstances()