最初に、アプリケーションのデータ・モデル部分を構築します。Java Persistence API（JPA）は、オブジェクト・リレーショナル・マッピングのPOJO永続化モデルを提供します。 コンポーネントを作成する前に、まず、アプリケーションとプロジェクトを作成する必要があります。

1. 「スタート」→「すべてのプログラム」→「Oracle Fusion Middleware 11.1.2.0.0」→「JDeveloper Studio 11.1.2.0.0」を選択して、Oracle JDeveloperを起動します。

2. ロールを選択するよう指示されたら、「Studio Developer (All Features) 」を選択して、「OK」をクリックします。

   

3. Tip of the Dayウィンドウを閉じます。

   ロードが終了すると、JDeveloper IDEが表示されます。詳細表示
   最初にJDeveloperを開くと、Start Pageが表示されます。後でStart Pageを再表示する場合は、「Help」→「Start Page」を選択します。
   
   
   JDeveloperについて学習するためのさまざまなオプションが用意されています。これらのオプションについて確認したら、「X」をクリックしてStart Pageタブを閉じます（Xは、タブにマウスを合わせると表示されます）。

4. 「Application」タブをクリックして、アプリケーション・ナビゲータに戻ります。「New Application」アイコンをクリックします。

   

5. New Galleryで、「Fusion Web Application (ADF)」オプションを選択します。

   

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

6. Create Applicationダイアログ・ボックスで、アプリケーション名にHR_EJB_JPAと入力します。アプリケーション名を入力すると、ディレクトリ名が自動的に変更される点に注意してください。アプリケーション・パッケージの接頭辞としてoracleと入力します。

   
   Fusion Web Applicationオプションを選択すると、2つのプロジェクトが作成されます。詳細表示
   
   ウィザードの各ページでデフォルト値を受け入れて「Next」をクリックしていくと、これから使用するプロジェクト名とパッケージ名が表示されます。また、ModelプロジェクトとViewControllerプロジェクトに対して特定の機能を選択できます。
   プロジェクト1のデフォルト・プロジェクト名はModelであり、デフォルト・パッケージ名はoracle.modelです。
   プロジェクト2のデフォルト・プロジェクト名はViewControllerであり、デフォルト・パッケージ名はoracle.viewです。

   「Finish」をクリックします。JDeveloperによってアプリケーション環境が作成されるまで待機します。

7. 作成された2つのプロジェクトがアプリケーション・ナビゲータに表示されます。右側のペインに表示されるアプリケーション概要を確認すると、手順の完了状況を把握できます。

   
   アプリケーションには2つのプロジェクトが含まれています。詳細表示
   
   この時点でModelプロジェクトは空ですが、データベース接続を作成するとEJB JPAコンポーネントが移入されます。
   ViewControllerプロジェクトには、UI構築に必要な基本コンポーネントが含まれています。
   
   Overviewペインでは、アプリケーション開発の手順についてのガイドが提供されています。この段階的な説明に従っていくと、アプリケーションを構築することができます。

ここでは、Oracle Application Server EJB 3.0 Entity Beanを使用して、部門および従業員の永続化モデルを作成します。 EJB 3.0 Entity Beanを作成するには、以下の手順を実行します。

1. アプリケーション・ナビゲータで「Model」ノードを右クリックし、コンテキスト・メニューから「New」を選択します。
   
   

2. New Galleryで、「All Features」タブを選択し、カテゴリとして「Business Tier」→「EJB」を選択し、「Entities from Tables」項目をダブルクリックします。

   

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

3. Select EJB Versionで、EJBバージョンとして「EJB 3.0 -- JPA Entities」が選択されていない場合はこれを選択し、「Next」をクリックします。

   

   「Next」をクリックして、永続性ユニットの定義をスキップします。

   EJB 3.0では、Entity Beanが大幅に簡素化され、POJO永続化モデルが標準化されています。詳細表示Entity Beanは具象Javaクラスであるため、インタフェースを必要としません。Entyty Beanクラスは、ポリモフィズムおよび継承をサポートします。エンティティは、さまざまなタイプの関係をもつことができ、コンテナ管理の関係は開発者によって手動で管理されます。

4. Type of Connectionページで「Online Database Connection」オプションを選択します。「Next」をクリックします。

   

5. Database Connection Detailsページで、Createボタン「」をクリックして新しい接続を作成します。

   

6. 次の値を入力して、HRスキーマに対するデータベース接続を作成します。ここに例として示した値は、使用環境に合わせて変更する必要があります。

   オプション	値
   Connection Name	HR
   Username/Password	hr/<使用しているhrパスワード>
   Save Password	チェック・ボックスを選択
   Driver	Thin
   Host Name	スキーマがインストールされているマシン（例：localhost）
   SID	HRスキーマがインストールされているデータベース（XE、orclなど）

7. 「Test Connection」をクリックして、接続可能であることを確認します。

   
   接続に成功したら、「OK」をクリックします。詳細表示
   接続に失敗した場合、正しいパラメータを入力しており、Oracleデータベースとリスナー・サービスが実行中であることを確認します。
   接続は、Initialize Business Components Projectページにも表示されます。

8. Database Connection Detailsページに戻り、「Next」をクリックします。

   

9. Select Tablesページで「Query」をクリックし、HRスキーマに使用可能なオブジェクトを取得します。次に、「DEPARTMENTS」と「EMPLOYEES」を選択し、右矢印ボタン「」を使用してそれらをSelectedペインに移動します。

   

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

10. ここで、パッケージ名がoracle.modelであることを確認します。

    

    「Next」に続き、「Finish」をクリックします。

11. アプリケーション・ナビゲータには、DepartmentsとEmployeesに1つずつjavaクラス・ファイルが作成されています。

    

12. Save All「」アイコンをクリックして作業内容を保存します。

EJBダイアグラムは、エンティティやJava Bean、およびこれらのコンポーネント間の関係を作成し、表示します。EJBダイアグラムを作成するには、以下の手順を実行します。

1. アプリケーション・ナビゲータで「Model」ノードを右クリックし、「New」を選択します。

   

2. New Galleryで、カテゴリとして「Business Tier」→「EJB」を選択し、「EJB Diagram (JPA/EJB 3.0)」項目をダブルクリックします。

   

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

3. Create EJB Diagramダイアログで、デフォルト・ダイアグラム名（EJB Diagram1）をHR EJB Diagramに変更し、デフォルト・パッケージ名がoracle.modelであることを確認します。

   

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

4. Associate Diagram With Persistence Unitダイアグラムで「OK」をクリックし、Persistence Unitとして提示されたModel.jprを受け入れます。

   

5. ダイアグラム・エディタで新しい空のダイアグラムが開きます。

   b
   ダイアグラム上でのEJB/JPAコンポーネントのモデル化は、開発者にとって便利な機能です。詳細表示Enterprise JavaBeans（EJB）をモデル化すると、EJBエンティティの関係やアーキテクチャを表示できるだけでなく、一連のBeanを素早く作成してプロパティやメソッドを生成し、これらのBeanのグラフィカル表示の作成や、Bean間の関係や参照を作成することができます。Beanがモデル化される際は常に、基礎となる実装ファイルも作成されます。

6. アプリケーション・ナビゲータから「Departments」エンティティと「Employees」エンティティを選択し、ダイアグラムにドラッグ・アンド・ドロップします。

   

7. 先ほど部門表と従業員表から作成したEJBコンポーネントがダイアグラムに表示されます。必要に応じてズームインし、両方のエンティティが水平に整列するようにダイアグラムのレイアウトを変更します。エンティティ間の関係を選択し、コンテキスト・メニューからStraighten linesオプションを使用すると、ダイアグラムを整理して表示することができます。

   

8. Save All「」アイコンをクリックして作業内容を保存します。

ここでは、従業員レコードおよび部門レコードを検索するメソッドを実装したSession Beanを作成します。

1. コンポーネント・パレットで、「EJB Components」ライブラリを選択し、「EJB Nodes」を開きます。

   

2. Session Beanコンポーネント「」を選択し、ダイアグラムにドラッグ・アンド・ドロップします。

   

   Create Session Beanウィザードが開きます（必要に応じて、Welcomeステップで「Next」をクリックします）。

3. EJB Name and Optionsステップで、EJB NameをHRFacadeに設定し、次の値が適切に設定されていることを確認します。

   プロパティ	値
   EJB Name	HRFacade
   Session Type	Stateless
   Transaction Type	Container
   Generate Session Facade Method	（チェック）
   Entity Implementation	JPA Entities
   Persistence Unit	Model

   
   

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

   Session Beanには、ステートフルとステートレスの2種類があります。 詳細表示
   
   ステートフルSession Beanは、クライアントの代わりに対話状態を維持します。対話状態は、Session Beanのフィールド値に加えて、Session Beanのフィールドからアクセスできるすべてのオブジェクトで定義されます。ステートフルSession Beanは永続データ・ストア内のデータを直接表すものではありませんが、クライアントに代わってこのデータにアクセスし、更新します。ステートフルSession Beanの存続時間は通常、そのクライアントの存続時間と同じになります。
   
   ステートレスSession Beanは、あくまでサーバー側の動作を提供するために設計されたものです。これらにはユーザー固有のデータが含まれないため、匿名のBeanになります。EJBアーキテクチャでは、単一のステートレスSession Beanを使用して多数のクライアントのニーズを満たすための手段が提供されています。ステートレスSession Beanインスタンスは、クライアント起動メソッドで使用されている場合を除いて、すべて同等です。ステートレスという用語は、特定のクライアントに対するステート情報を保持していないことを意味します。ただし、ステートレスSession Beanは、オープン・データベース接続などのクライアントに依存しない状態を保持できます。
   
   セッション・ファサードとBeanによって処理されるトランザクションでは、コンテナを使用することでプログラムによるプロセスを介して明示的にユーザー・トランザクションを管理することができます。

4. Session Facadeステップでは、このプロジェクトのエンティティがすべてツリー・コントロールのノードとして表示されます。すべてのエンティティ・メソッドを含むチェック・ボックスを選択することも、各ノードを開いてメソッドのサブセットを選択することもできます。
   「Employees」ノードと「Departments」ノードを開き、それぞれのエンティティに対してすべてのメソッドを選択します。

   

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

5. Class Definitionステップで、Beanクラスのフルネームがoracle.model.HRFacadeBeanであることを確認してから、「Next」をクリックします。

   

6. 次のステップでは、リモート・インタフェースとローカル・インタフェースの実装が選択されていることを確認します。リモート・インタフェースは、Javaクライアントなどの個別の仮想マシンで実行されるクライアント・アプリケーションで使用されます。一方ローカル・インタフェースは、Webクライアントなどの同じ仮想マシンで実行されるクライアント・アプリケーションで使用されます。

   

   「Next」をクリックして、作成したクラスの内容を確認します。次に、「Finish」をクリックします。

7. ダイアグラムは次のように表示されます。

   

8. アプリケーション・ナビゲータは、次のように表示されます。

   

   Session Beanは、3つのファイルで構成されています。Session Beanコードを含むHRFacadeBean、リモート・クライアントのBean機能を表すHRFacade、およびローカル・クライアントの機能を表すHRFacadeLocalです。

9. Save All「」アイコンをクリックして作業内容を保存します。

ここでは、Oracle ADFフレームワークのデータ・コントロールとしてEJBを公開します。これによって、ユーザー・インタフェースをEJBにバインドする方法が簡素化されます。ADFフレームワークの詳細は、下記のWebサイトを参照してください。http://oracle.com/technology/products/adf
EJB Session BeanからADFデータ・コントロールを作成するには、次の手順を実行します。

1. アプリケーション・ナビゲータで「HRFacadeBean」ノードを右クリックし、コンテキスト・メニューから「Create Data Control」を選択します。

   

2. Choose EJB Interfaceダイアログで、「Local」を選択し、「OK」をクリックします。

   

   Save All「」をクリックして作業内容を保存します。

3. アプリケーション・ナビゲータは、次のように表示されます。

   
   データ・コントロールを作成すると、プロジェクトにさまざまな変更が追加されます。 詳細表示
   
   EJBSession Beanに基づくデータ・コントロールを作成すると、JDeveloperによってデータ・コントロール定義ファイル（DataControls.dcx）が作成され、概要エディタ内でこのファイルが開かれ、Data Controlsパネルにファイル階層が表示されます。このファイルを使用することで、データ・コントロールはサービスやバインディングと直接連携することができます。

4. 「Data Controls」アコーディオンを開き、UIから使用できるようになった作成済みのコンポーネントを確認します。

   

5. 利用可能なデータ・コントロールがData Control Registryに表示されることに注意してください。

   

6. 「HRFacadeLocal 」ノードを展開します。「departmentsFindAll」ノードを選択すると、右側にデータ・コントロールの詳細が表示されます。

   
   DataControls.dcxファイルの概要エディタに、データ・モデルのマスター・ディテール階層ビューと、セッション・ファサードのメソッドが表示されます。 詳細表示
   
   ノードを選択すると、該当するエンティティ・クラスのBeanプロパティがAttributesタブに表示されます。Accessorsタブには、該当するエンティティ・クラスに含まれ、コレクションを返すすべてのBeanプロパティが表示されます。またOperationsタブでは、このエンティティ上で実行されるセッション・ファサードのその他のメソッドを確認できます。

7. 「Model」プロジェクト・ノードを閉じ、いずれかのタブを右クリックして開いているタブをすべて閉じます。