JDeveloperで、新しいワークスペースとプロジェク トを作成します。
「ファイル」メニューから「新規」を選択します。

「新規ギャラリ」ページが表示されます。

「カテゴリ」ペインで、「General」を選択します。 「項目」ペインで「ワー クスペース」を選択し、「OK」をクリックします。

「ワークスペース作成」ダイアログ ボックスが表示されます。

「ワークスペース作成」ダイアログ ボックスで、ワークスペース名としてTopLinkTutorialsを 入力し、「OK」をクリックします。

「プロジェクトの作成」ダイアログ ボックスが表示されます。

「プロジェクトの作成」ダイアログ ボックスで、プロジェクト名としてEmployeeを 入力し、「OK」をクリックします。

ワークスペースおよびプロジェクトがナビゲータに追加されます。

アプリケーション・ナビゲータで「Employee」を右クリックし、「新 規」を選択します。

「新規ギャラリ」ページが表示されます。

「フィルタ方法」ドロップダウン・リストで、「すべてのテクノロジ」を選択しま す。
「カテゴリ」ペインで、「General」→「Deployment Descriptors」を選択します。
「項目」ペインで、「TopLink Mappingディスクリプタ」を選択し「OK」をクリックします。

TopLink Mappingsの要素がナビゲータに表示されます。

「TopLink Mappings」を右クリックし、「デフォルトのマッ ピング」を選択します。

「TopLink Mappings」ページが、マッピング・エディタに表示され、「構造」ウィンドウも表示されます。

アプリケーション・ナビゲータで「Employee」 ノードを右クリックし、「プロジェクトに追加...」を選択します。

「ファイルまたはディレクトリを追加」ダイアログボックスが表示されます。

このレッスン用のファイルが格納されているexamplesディ レクトリに移動し、「開く」をクリックします。 これらのファイルが未解凍の場合は、前述の「前提条件」を参照してください。

「ファイルの選択の調整」ウィンドウで、次のクラスを選択し ます。

examples.sessions.threetier.model.Address.java
examples.sessions.threetier.model.Employee.java
examples.sessions.threetier.model.PhoneNumber.java

「プロジェクト・ディレクトリにファイルをコピー」を選択し「OK」 をクリックして、Javaクラスをインポートします。

「ナビゲータ」ペインで「TopLink Mappings」を選択します。
「TopLink Mappings - 構造」ウィンドウで「ディスクリプタの追加またはプロジェクトからの削除」をクリックします。

「TopLinkディスクリプタ」ダイアログ ボックスが表示されます。

「使用可能なパッケージ/クラス」領域でexamples.sessions.threetier.modelパッ ケージを選択し、このパッケージを「選択したクラス」に移動します。

「OK」をクリックします。 JDeveloperにより、JavaクラスごとにTopLinkディスクリプタが作成されます。

「ファイル」メニューから「すべて保存」を選択します。

ナビゲータで「Employee」を右クリックし、「新 規」を選択します。

「新規ギャラリ」ページが表示されます。

「カテゴリ」ペインで、「Database Tier」→「Offline Database Objects」を選択します。
「項目」ペインで「データベースからインポートされたオフライン・データベース・オブジェクト」を選択します。

「OK」をクリックします。 「オフライン・データベースのインポート」ウィザードが表示されます。

最初のページの情報を確認し、「次へ」をクリックします。
接続名としてtltutorialを選択します。 この接続が作成されていない場合は、前述の「前提条件」を参照してください。 「次 へ」をクリックします。

「使用可能」セクションで「ADDRESS」、「EMPLOYEE」 および「PHONE」を選択し、 移動ボタンによりこれらのオブジェクトを「選択済」セクションに移動させ、「次へ」をク リックします。

スキーマ名は、デフォルトのTLTUTORIALをそのまま使用し、「終了」 をクリックします。 JDeveloperにより、オフライン・データベース表がプロジェクトに追加されます。

ナビゲータで「TopLink Mappings」 を選択します。
「TopLink Mappings - 構造」ペインのAddressディスクリプタをダブル・クリックします。

「エディタ」ペインにTopLinkマッピング・エディタが表示されます。

マッピング・エディタで「ディスクリプタ情報」タブをクリックします。 「関連表」フィールドでTLTUTORIAL.ADDRESS表を選択します。 TopLinkは、各ディスクリプタの主キーを自動的に識別します。

手順1と2を繰り返し、次の対応付けを行います。

EmployeeとTLTUTORIAL.EMPLOYEE表
PhoneNumberとTLTUTORIAL.PHONE表

これにより、ディスクリプタは特定のデータベース表に対応付けられましたが、クラス属性と表の列 の対応付けはまだ行われていません。 この対応付けは、このレッスンの後半で行います。

「ファイル」メニューから「すべて保存」を選択します。

「TopLink Mappings - 構造」ウィンドウでAddressディスクリプタを展開します。

ディスクリプタの属性が表示されます。

「city」をクリックします。

「エディタ」ペインに、この属性に有効なマッピングが表示されます。

「フィールドへ直接」を選択し「マップ」をクリックします。

「エディタ」ペインにフィールドへのダイレクト・マッピングの「一般」タブが表示されます。

「構造」ウィンドウで「city」属性を右クリックし、コンテキスト・メニューか ら「マップ」→「フィールドへ直接」を選択するか、またはTopLink Mappings 構造ツールバーで「マッ プ」をクリックして、属性のマッピングを行うこともできます。

「データベース・フィールド」で「CITY」を選択します。

手順2～4を繰り返し、残りの属性のADDRESS表へのマッピングを行います。

country属性とCOUNTRYフィールドへのマッピング
id属性のADDRESS_IDフィールドへのマッピング
postalCode属性のP_CODEフィールドへのマッピング
province属性のPROVINCEフィールドへのマッピング
street属性のSTREETフィールドへのマッピング

手順1～4を繰り返し、次の属性のEMPLOYEE表へのマッピングを行います。

firstName属 性のF_NAMEフィールドへのマッピング
id属性のEMP_IDフィールドへのマッピング
lastName属性のL_NAMEフィールドへのマッピング

手順1～4を繰り返し、次の属性のPHONE表へのマッピングを行います。

areaCode属性のAREA_CODEフィールドへのマッピング
number属性のP_NUMBERフィールドへのマッピング
type属性のTYPEフィールドへのマッピング

「構造」ウィンドウでEmployeeディスクリプタを展開 します。

「構造」ペインで「address」属性をクリックします。 「エディタ」ペインに、この属性に有効なマッピングが表示されます。

「１対１」を選択し「マップ」 をクリックします。 「エディタ」ペインに1対1マッピングの「一般」タブが表示されます。

「構造」ウィンドウでaddress属性を右クリックし、コンテキスト・メニューから「マッ プ」→「１対１」を選択するか、またはTopLink Mappings 構造ツールバーで「マップ」をクリックし て、属性のマッピングを行うこともできます。

「参照ディスクリプタ」フィールドで「Address」を選択します。 「ValueHolder インダイレクションの使用」オプションおよび「私有」オプションが選択されていることを確認します。 これにより、Addressオブジェクトの所有者である従業員が変化すると、Addressオブジェクトが自動的に作成、更新または削除されます。

1対1マッピングでは、リレーショナル・データベースの外部キーの概念を使用して、データベース 内に格納されている他のクラスのデータへアクセスします。 TopLinkが参照対象のオブジェクトの検索方法を認識できるよう、ディスクリプタに外部キー情報を指定する必要があります。

「表参照」タブをクリックします。
「表参照」ドロップダウン・リストから「EMPLOYEE_ADDRESS」を選択します。

この表参照では、外部キーはEMPLOYEE表のADDRESS_IDで、主キーは ADDRESS表のADDRESS_IDです。

手順1～6を繰り返し、PhoneNumberディ スクリプタのowner属性を、1対1マッピングとし てEmployeeクラスにマッピングします。

参照ディスクリプタとしてEMPLOYEEを選択します。
「表参照」タブでPHONE_EMPLOYEE表を選択します。

「構造」ウィンドウでEmployeeディス クリプタを展開します。

phoneNumbers属性をクリックします。 「エディタ」ペインに、この属性の有効なマッピングが表示されます。

「１対多」を選択し「マップ」 をクリックします。 「エディタ」ペインに一対多マッピングの「一般」タブが表示されます。

「構造」ウィンドウでphoneNumbers属 性を右クリックし、コンテキスト・メニューから「マップ」→「１対多」を選択するか、またはTopLink Mappings 構造ツールバーで「マップ」をクリックして、属性のマッピングを行うこともできます。

「参照ディスクリプタ」ドロップダウン・リストから「PhoneNumber」を 選択します。

「表参照」タブをクリックし、PHONE_EMPLOYEE表を選択します。

TopLink Mappingsのデプロイメント接続を作成します。 「構造」ペインでToplink Mappingsを選択し、「データベース情報」タブをクリックします。 「デプロイ接続」ドロップダウン・リストからtltutorialを 選択します。

アプリケーション・ナビゲータでTopLinkパッケージの下にある「TopLink Mappings」を右クリックし、「新規sessions.xm」を選択します。

sessions.xmlをダブルクリックして、このファイルをエディタで開きま す。

「追加」をクリックし、新しいセッションを作成します。

セッション名をIntroToplinkSessionに変更します。

「OK」をクリックして、セッションを作成します。

TopLinkのデプロイメント・ディスクリプタを作成します。 アプリケーション・ナビゲータで「TopLink Mappings」を右クリックし、コンテキスト・メニューから「toplink- deployment-descriptor.xmlの生成」を選択します。

JDeveloperがJavaソースをコンパイルし、TopLinkのマッピングをチェック し、toplink-deployment-descriptor.xmlファ イルを生成します。 「OK」をクリックし、デプロイメント・ディスクリプタ・ウィンドウを閉じます。

Employee.javaオブジェクトのデータ管理層を作成します。
ナビゲータで「Employee.java」を右クリックし、コンテキスト・メニューから「データ・コントロールの作成」を 選択します。

「Select Deployment Resource」ダイアログ ボックスで「Sessions Configuration」を選択し、「Location」にsessions.xmlを指定し、「Sessions」にIntroToplinkSessionを 指定します。

JavaオブジェクトからのデータをレンダリングするためのJSPページを作成します。
ナビゲータでEmployeeプロジェクトを右クリックし、コンテキスト・メニューから「新規」を選択します。

「新規ギャラリ」ページが表示されます。

「カテゴリ」ペインで「Web Tier」を選択し、その下の「JavaServer Pages (JSP)」を選択します。 「項目」ペインで、「JSPページ」を選択します。

「OK」をクリックします。

JSPの名前をToplink.jspに変更します。

「OK」をクリックします。 ビジュアル・エディタにJPSが表示されます。

「データ・コントロール・パレット」ペインで、EmployeeDataControlノー ドおよびreadAllEmployeeノードを展開し、returnノードを選択します。 「ドラッグ・アンド・ドロップの形式」ドロップダウン・リストで「Read-Only Table」が選択されていることを確認します。

returnノードをビジュアル・エディタにドラッグします。

右クリックして「実行」を選択し、JSPページを実行します。