retrieveInstances()

特定の参加者インスタンスを含むゼロまたは複数の関係インスタンスの関係インスタンス ID のみを検索します。

構文

int[] retrieveInstances(String relDefName, 
 String partDefName,
      BusObj partData)
  
 int[] retrieveInstances(String relDefName, 
 String partDefName,
       String partData)
  
 int[] retrieveInstances(String relDefName, 
 String partDefName,
       long partData)
  
 int[] retrieveInstances(String relDefName, 
 String partDefName,
       int partData)
  
 int[] retrieveInstances(String relDefName, 
 String partDefName,
       double partData)
  
 int[] retrieveInstances(String relDefName, 
 String partDefName,
       float partData)
  
 int[] retrieveInstances(String relDefName, 
 String partDefName,
      boolean partData)
  
 int[] retrieveInstances(String relDefName, 
 String[] partDefList,
       BusObj partData)
  
 int[] retrieveInstances(String relDefName, 
 String[] partDefList,
       String partData)
  
 int[] retrieveInstances(String relDefName, 
 String[] partDefList,
        long partData)
  
 int[] retrieveInstances(String relDefName, 
 String[] partDefList, 
       int partData)
  
 int[] retrieveInstances(String relDefName, 
 String[] partDefList,
       double partData)
  
 int[] retrieveInstances(String relDefName, 
 String[] partDefList,
        float partData)
  
 int[] retrieveInstances(String relDefName, 
 String[] partDefList,
       boolean partData)
  
 int[] retrieveInstances(String relDefName, BusObj partData)
 int[] retrieveInstances(String relDefName, String partData)
 int[] retrieveInstances(String relDefName, long partData)
 int[] retrieveInstances(String relDefName, int partData)
 int[] retrieveInstances(String relDefName, double partData)
 int[] retrieveInstances(String relDefName, float partData)
 int[] retrieveInstances(String relDefName, boolean partData)
 

パラメーター

relDefName
関係定義の名前。

partDefName
参加者定義の名前。

partDefList
参加者定義のリスト。

partData
参加者に関連付けられたデータ。データ型は、BusObjStringlongintdoublefloatboolean のいずれかです。

戻り値

参加者を含む関係のインスタンス ID である整数の配列を戻します。

例外

RelationshipRuntimeException 
 

注記

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

retrieveInstances() で指定したデータの関係インスタンスが見つからなかった場合、例外は生成されません。関係表にデータがない場合でも、ルックアップが適切に実行されなかったとは限りません。retrieveInstances() で値が見つからなかったときに例外を生成したい場合は、メソッドが戻すインスタンス ID の値を検査して、値が null の場合は、MapFailureException を明示的に生成する必要があります。

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

参照項目

addMyChildren(), deactivateParticipant(), deleteParticipant(), retrieveParticipants()

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

Copyright IBM Corp. 2004