84 EISの1対多マッピングの構成

この章では、EISの1対多マッピングを使用するために構成する必要のある様々なコンポーネントについて説明します。

この章の内容は次のとおりです。

EISの1対多マッピング構成の概要
外部キー・ペアの構成
すべて削除インタラクションの構成

複数のマッピング・タイプに共通のTopLinkマッピング・オプションを構成する方法の詳細は、第121章「マッピングの構成」を参照してください。

TopLinkマッピングの作成方法の詳細は、第120章「マッピングの作成」を参照してください。

84.1 EISの1対多マッピング構成の概要

表84-1は、EISの1対多マッピングの構成可能オプションを示します。

表84-1 EISの1対多マッピングの構成可能オプション

構成オプション	Oracle JDeveloper	TopLink Workbench	Java
参照ディスクリプタ（78.3項「参照ディスクリプタの構成」を参照）
外部キー・ペア（84.2項「外部キー・ペアの構成」を参照）
双方向リレーションシップ（121.18項「双方向リレーションシップの構成」を参照）
マッピング・レベルでのメソッドまたは直接フィールド・アクセス（121.6項「マッピング・レベルでのメソッドまたは直接フィールド・アクセスの構成」を参照）
読取り専用マッピング（121.2項「読取り専用マッピングの構成」を参照）
プライベート・リレーションシップまたは独立したリレーションシップ（121.7項「プライベート・リレーションシップまたは独立したリレーションシップの構成」を参照）
インダイレクション（遅延ロード）（121.3項「インダイレクション（遅延ロード）の構成」を参照）
コンテナ・ポリシー（121.14項「コンテナ・ポリシーの構成」を参照）
マッピング・コメント（121.8項「マッピング・コメントの構成」を参照）
選択インタラクション（78.4項「選択インタラクションの構成」を参照）
すべて削除インタラクション（84.3項「すべて削除インタラクションの構成」を参照）

詳細は、次を参照してください。

84.2 外部キー・ペアの構成

1対多のEISマッピングでは、ソースおよびターゲット・オブジェクトのフィールドを1つ以上指定して、ターゲット・オブジェクトの属性にソース・オブジェクトの属性を関連付けます。

XMLレコードを使用するソースにキーのある状態の1対多のEISマッピング（77.8.1項「ソースにキーのある状態でのEIS 1対多マッピング」を参照）では、TopLinkで単純な値としてターゲットのXMLフィールドの値をソース・オブジェクトのレコードに置きます。デフォルトではこのような値はグループ化されません（例84-1を参照）。

例84-1 グループ化のないソース・オブジェクトXMLレコード

<employee>
    <name>Jane</name>
    <project-id>3</project-id>
    <project-id>4</project-id>
</employee>

ソースおよびターゲットXMLフィールドのペアを複数指定した場合は、グループ化要素を指定する必要があります（例84-2を参照）。

例84-2 グループ化のあるソース・オブジェクトXMLレコード

<employee>
    <name>Jane</name>
    <project>
        <project-id>3</project-id>
        <project-name>Project 3</project-name>
    </project>
    <project>
        <project-id>4</project-id>
        <project-name>Project 4</project-name>
    </project>
</employee>

XMLレコードを使用する、ターゲットにキーのある状態の1対1のEISマッピング（77.8.2項「ターゲットにキーのある状態でのEIS 1対多マッピング」を参照）では、TopLinkで選択インタラクションのソースXMLフィールドの値を使用してターゲット・オブジェクトの該当するインスタンスを取得します。

84.2.1 TopLink Workbenchを使用した外部キー・ペアの構成方法

1対多のEISマッピング用にソースおよびターゲットXMLフィールドのペアを指定するには、次の手順を実行します。

ナビゲータで1対1のEISマッピングを選択します。そのプロパティがエディタに表示されます。
「一般」タブをクリックします。「一般」タブが表示されます。

図84-1 「一般」タブ、「外部キー」フィールド

「図84-1 「一般」タブ、「外部キー」フィールド」の説明

次の情報を参照し、「一般」タブの「外部キー」フィールドを完成させます。

フィールド	説明
ターゲットにある外部キー	ターゲットにキーのある状態で1対多EISマッピングを作成するかどうかを選択します（77.8.2項「ターゲットにキーのある状態でのEIS 1対多マッピング」を参照）。
ソースにある外部キー	ソースにキーのある状態で1対多EISマッピングを作成するかどうかを選択します（77.8.1項「ソースにキーのある状態でのEIS 1対多マッピング」を参照）。
グループ化要素	外部キー・ペアがソース・オブジェクトのEISレコードでグループ化される要素を指定します。ソースおよびターゲットXMLフィールドのペアを1つのみ指定した場合、これはオプションです。ソースおよびターゲットXMLフィールドのペアを複数指定した場合、これは必須です。
フィールド・ペア	「追加」をクリックして、ソースおよびターゲットXMLフィールドの1ペアを追加します。「フィールド・ペアの指定」ダイアログ・ボックスを開きます。「参照」をクリックして、「ソースXPath」および「ターゲットXPath」フィールドの外部キーを追加します。

84.3 すべて削除インタラクションの構成

TopLinkの問合せおよび式フレームワークでは、すべての問合せの削除をサポートします。JCAアダプタがEISのすべて削除ファンクションにアクセスできる場合は、すべて削除インタラクションを構成してTopLinkですべての問合せを削除できるようにします。

84.3.1 TopLink Workbenchを使用したすべて削除インタラクションの構成方法

EISの1対多マッピングについて、「すべて削除インタラクション」を指定するには、次の手順を実行します。

ナビゲータでマップされた属性を選択します。そのプロパティがエディタに表示されます。
「すべて削除インタラクション」タブをクリックします。「すべて削除インタラクション」タブが表示されます。

図84-2 「すべて削除インタラクション」タブ

「図84-2 「すべて削除インタラクション」の説明

次の情報を参照し、「すべて削除インタラクション」タブの各フィールドにデータを入力します。

フィールド	説明
ファンクション名	このタイプのコール（「オブジェクトの読取り」または「すべて読取り」）がEISに対して起動するEISファンクションの名前。
入力レコード名	入力レコードの作成時に、JCAアダプタに渡される名前。
入力ルート要素名	入力DOMに使用されるルート要素名。
入力引数	引数レコードのインタラクション・フィールドまたはXPathノードにマップされる問合せ引数名。たとえば、XMLレコードを使用している場合、このオプションを使用して入力引数`name`をXPath `name/first-name`にマップします。
出力引数	ディスクリプタのマッピングに使用されるレコード内の正しいノードにマップされる、結果のレコード・フィールドまたはXPathノード。たとえば、XMLレコードを使用している場合、このオプションを使用して出力`fname`を`name/first-name`にマップします。対話でディスクリプタのマッピングと一致するXML結果が返される場合、出力引数は必要ありません。
入力結果のパス	EISインタラクションが、XMLレコードにネストされるインタラクション引数を予期する場合に、このオプションを使用します。たとえば、引数を最初にルート要素`exec-find-order`の下に、次に`arguments`要素の下にネストする必要がある場合は、`arguments`を指定します。
出力結果のパス	このタイプのコール（「オブジェクトの読取り」または「すべて読取り」）がEISに対して起動するEISファンクションの名前。
プロパティ	EISプラットフォームが必要とするプロパティ。たとえば、プロパティ名`operation`（`AQPlatform.QUEUE_OPERATION`から）およびプロパティ値`enqueue`（`AQPlatform.ENQUEUE`から）。