チュートリアルの手順と例は、Fusion Order Demo（FOD）スキーマに含まれる複数の表に基づいています。このスキーマは、Oracle JDeveloper 11gに付属しているサンプル・アプリケーションのデータベースとして、さらに、このリリースの他の補足情報としても使用されます。詳細表示

このスキーマをインストールしていると便利です。インストールは1回で済みます。FODスキーマをすでにインストールしている場合は、このステップを飛ばして次に進んでください。スキーマをインストールするには、ユーザーを作成する権限を持つ特権（DBA）ユーザーへのアクセスとOracleデータベースも必要になります。このスキーマは、Oracle 10gバージョン（またはそれ以降）のデータベースで有効です。スキーマをインストールするには、zipファイルをダウンロードして展開し、Antを使用してインストールを実行します。

1. OTNからschema.zipファイルをダウンロードします。

2. ファイルを適切な場所（c:\tempなど）に解凍します。

3. Fileメニューから「Open」を選択します。ワークスペースc:\temp\Infrastructure\Infrastructure.jwsを開きます。

4. プロジェクトを移行するよう指示されたら、「Yes」をクリックして確定します。次に「OK」をクリックします。

5. アプリケーション・ナビゲータで、「MasterBuildScript」プロジェクトを展開します。Resourcesの下にある「build.properties」をダブルクリックして、エディタで開きます。

6. build.propertiesファイルに適切な値を設定します（jdeveloper.homeと、jdbc.*およびdb.*のすべてを設定）。他のプロパティは、すべてデフォルト値のままにしておきます。demoユーザーの名前をFODにする必要があります。
   
   関連する設定は、次のとおりです。

   設定	説明
   jdeveloper.home	JDeveloperがインストールされている/jdeveloperディレクトリ（例：c:/JDeveloper_11/jdeveloper/）
   jdbc.urlBase	データベースのベースURL（例：jdbc:oracle:thin:@localhost）
   jdbc.port	データベースのポート番号（例：1521）
   jdbc.sid	データベース・システムの識別子（例：XEまたはORCL）
   db.adminUser	管理者権限を持つデータベース・ユーザー（例：system）
   db.demoUser.tablespace	FODユーザーをインストールする表領域の名前（例：USERS）

7. MasterBuildScriptプロジェクトで、「build.xml」ファイルを選択します。

8. Structureウィンドウで、「refreshSchema」ターゲットを右クリックして、「Run Target "refreshSchema"」を選択します。

9. 入力の指示が表示されたら、管理者権限を持つデータベース・ユーザーのパスワードを入力します。Antタスクの実行後、JDeveloper Logウィンドウでbuild successfulメッセージを確認できます。
   
   
   
   エラーがある場合、データベースが実行中であるかどうか（SQL*Plusで接続を試みます）、build.propertiesファイルに設定した値が正しいかどうかを確認する必要があります。また、指定したDBAユーザーにCREATE USER権限があることも確認してください。

1. メイン・メニューから「File」→「New」を選択します。New Galleryで「General」カテゴリを展開し、「Applications」を選択します。Itemsリストで「Custom Application」を選択し、「OK」をクリックします。

   
JDeveloperアプリケーションは、組織構造の最上位レベルです。アプリケーションの開発中に、操作しているオブジェクトの情報がここに格納されます。詳細表示同時に、プロジェクトとすべての環境設定が追跡記録されます。

JDeveloperアプリケーションを使用すると、作成するアプリケーションのタイプ（WebアプリケーションやJavaアプリケーションなど）に応じて、ビルトイン・テンプレートを基に、事前定義された環境のタイプを指定できます。アプリケーション・テンプレートを使用すると、適切な機能の組合せが事前に指定されているため、標準アプリケーションのプロジェクト構造を迅速に作成できます。また、使用している機能に合った選択肢のみが使用できるように、JDeveloperで実行する処理がアプリケーション・テンプレートによりフィルタリングされます。

このチュートリアルでは、Custom Applicationテンプレートを使用します。このテンプレートでは、JDeveloperがサポートするすべての機能の関連オブジェクトを1つのプロジェクトから使用できます。

適切なテンプレートを使用してアプリケーションを作成した後も、新しいプロジェクトをアプリケーションに追加したり、組み込む機能を指定したりすることができます。これを実行するには、アプリケーション・ナビゲータでアプリケーション名を右クリックして、「New Project」を選択します。New Galleryでは、任意のタイプのプロジェクトをItemsリストから選択できます。

2. この例に合わせるため、アプリケーション名としてProductsApplicationと入力します。

   
初期プロジェクト構造（アプリケーションの作業領域内にある名前付きプロジェクト・フォルダ）および追加されるアプリケーション・ライブラリは、選択したアプリケーション・テンプレートによって決まります。詳細表示関連する機能はアプリケーション内の1つ以上のプロジェクトにより定義されます。

JDeveloperのプロジェクトは、関連するファイルを論理的にグループ化するために使用されるものですが、ここではソース・ファイル、パッケージ、クラス、イメージ、およびプログラムに必要なその他の要素の追跡も行われます。プロジェクトでは、プログラムのコンパイル時や実行時に使用するソース・パスや出力パスなどの環境変数を管理します。また、プロジェクトには、コンパイラ、ランタイム、デバッグに関するオプションが用意されており、プロジェクトごとにこれらのツールの動作をカスタマイズできます。

ソース・コードのアクセス、変更、再利用を簡単にするために、複数のプロジェクトをアプリケーションに追加できます。それぞれのプロジェクトに含まれるファイルは、たとえば多層アプリケーションにおける各層に相当する場合もあれば、複雑なアプリケーションにおける各サブシステムに相当する場合もあります。これらのファイルはどのディレクトリに配置されていても、1つのプロジェクトに含めることができます。

3. デフォルト値のままにして、「Finish」をクリックします。
   
   アプリケーション・ナビゲータのProjectsパネルは、次のように表示されます。
   
   

テンプレートから作成された新規アプリケーションは、プロジェクト階層に分割されてアプリケーション・ナビゲータに表示されます。各プロジェクトには関連する機能が設定されています。詳細表示アプリケーション・ナビゲータでは、プロジェクトは階層内の最上位レベルとして表示されます。アプリケーションで使用したCustom Applicationテンプレートによって、1つのプロジェクトが作成されています。このプロジェクトには、デフォルトのプロジェクト名または事前に入力されたプロジェクト名が指定されています。

アプリケーション・ナビゲータのパネルはいずれも任意に開閉できます。パネルのサイズを調整するには、2つのパネルの間にある分割線をドラッグします。Projectsパネルで項目のグループ化やソートを行うには、「」Navigator Display Optionsドロップダウン・メニューを使用します。アプリケーションを操作するには、「」Application Menuをクリックしてドロップダウン・メニューからオプションを選択します。

JDeveloperには多種多様なファイル・タイプを識別する機能が備わっており、アプリケーション・ナビゲータでファイルをダブルクリックすると、適切なビューアまたはエディタでファイルが表示されます。アプリケーションまたはプロジェクトを終了すると、そのアプリケーションまたはプロジェクトのファイルを表示していたすべてのエディタまたはビューアが閉じられ、メモリからファイルがアンロードされます。

注：アプリケーション・ナビゲータのイタリック体のノードは、これらの要素が保存されていないことを示しています。プロジェクトに含まれるファイルが選択されている場合、プロジェクト・ノードは太字で表示されます。

メイン・メニューから「Application」→「Show Overview」を選択します。エディタ・ウィンドウ領域にApplication Overviewウィンドウが開きます。



Application Overviewのファイル概要ページには、JDeveloper内で作成されるすべてのオブジェクトがオブジェクト・タイプごとに分類されて表示されます。新規作成したファイルとアーチファクトは、ステータスやプロジェクトでフィルタして表示できます。

このアプリケーションのオブジェクトを作成する際には使用しないので、任意でApplication Overviewウィンドウを閉じることができます。

インストールしたデータベースへの接続を確立し、Fusion Order Demo（FOD）のスキーマを使用できるようにします。

1. メイン・メニューから「File」→「New」→「General」→「Connections」→「Database Connection」の順に選択し、「OK」をクリックしてCreate Database Connectionダイアログを開きます。

   

2. Create Connection Inオプションとして選択されていない場合は、「Application Resources」を選択します。

3. 接続の名前を入力し、接続タイプを選択して、ユーザー名とパスワードを入力します。この例では、接続名にFOD、ユーザー名にfodを使用します。

   

4. Oracle JDBC Settingsに値を入力して、使用するデータベースのホスト、ポート、SIDを指定します。

   

5. 「Test Connection」をクリックして、接続可能であることを確認します。接続に成功したら、「OK」をクリックします。

6. アプリケーション・ナビゲータで、「Application Resources」パネルを展開し、「Connections」ノードと「Database」ノードを展開して、データベース・オブジェクトを表示します。

   
作成したデータベース接続（例：FOD）がアプリケーションのリソースとして、Connections→Databaseノードの下に設定されました。詳細表示

作成した接続ノードを展開し、多数ある「+」アイコンをクリックしてスキーマとデータベース・オブジェクトを表示します。



データベース接続をアプリケーション・リソースに追加したら、必要に応じてApplication Resourcesパネルを縮小し、アプリケーション・ナビゲータのProjectsパネルのサイズを大きくできます。

Enterprise JavaBeans（EJB）3.0仕様には、軽量Javaオブジェクトの作成、削除、問合せをおこなうためのAPIであるJava Persistence API（JPA）と呼ばれる永続化仕様が追加されています。EJB 3.0仕様は、"beans"としてエンティティを参照しません。JPAエンティティを参照します。

JPAエンティティの作成を開始するには、Create Entities from Tablesウィザードを起動します。

Java Persistence API（JPA）は、Javaの永続性を大幅に簡素化します。Javaオブジェクトをリレーショナル・データベース表へ宣言的に定義する、標準的かつ移植性の高いオブジェクト・リレーショナル・マッピング・アプローチを提供します。このアプローチは、Java EE 5アプリケーション・サーバーの内部およびJava Standard Edition（Java SE）5アプリケーションのEJBコンテナ外部の両方で動作します。詳細表示

JPA永続性ディスクリプタ・ファイル（persistence.xml）を必要とするJARファイルの永続性アーカイブで、JPAエンティティ・アプリケーションをパッケージ化できます。 1つ以上の永続性ユニットがpersistence.xmlファイルで構成されます。それぞれの永続性ユニットには名前が必要です。名前のついた永続性ユニットによって、一連のメタデータ・ファイル、クラス、およびすべてのクラスがグループで保存されるjarを指定する便利な方法が実現します。

Create Entities from Tablesウィザードを使用してJPAエンティティを作成すると、Oracle JDeveloperによってデフォルトの永続性ユニットが自動的に作成されます。アプリケーション・ナビゲータで、「Application Sources」に続いて「META-INF」を展開します。「persistence.xml」をダブルクリックして、概要エディタでファイルを開きます。 必要に応じて、Overviewをクリックし、概要エディタに切り替えます。新しい永続性ユニットを作成する際にJPA永続性の概要エディタを使用して、persistence.xmlファイルの既存の永続性ユニットを削除または編集します。



Oracle JDeveloperによって作成されたデフォルトの永続性ユニットは、persistence.xmlファイル内ではProject1という名前になっています。 永続性ユニットのデフォルト名がプロジェクト名から作成されるので注意してください。 この例では、デフォルトのProject1永続性ユニットを使用していません。 代わりに、次のステップで実行されるJava EEコンテナ外部で実行するために構成された新しい永続性ユニットを作成しています。

1. アプリケーション・ナビゲータで、作成したプロジェクトを右クリックして、「New」 > 「Business Tier」 > 「EJB」 > 「Entities from Tables」を選択します。その後「OK」をクリックして、Create Entities from Tablesウィザードを立ち上げます。

   

2. ステップ1のVersionウィザードで、「EJB 3.0 -- JPA Entities」を選択します。「Next」をクリックします。

   

3. ステップ2のPersistence Unitウィザードでは、新しいユニットを作成しないでください。「Next」をクリックします。

   

4. ステップ3のType of Connectionで、「Online Database Connection」を選択します。「Next」をクリックします。

5. ステップ4のDatabase Connection Detailsでは、Connectionドロップダウン・リストでFODが選択されているかどうかを確認します。「Next」をクリックします。

6. ステップ5のSelect Tablesで、「Query」をクリックし、Availableリストを追加します。 リストからPRODUCTS_BASEを選択し、「」をクリックしてSelectedリストに追加します。「Next」をクリックします。

   

7. ステップ6のGeneral Optionsでは、デフォルトのパッケージ名をそのまま使用します。 Entity Class Optionsで、次のオプションが設定されているかを確認し、「Next」をクリックします。

   オプション	値
   フィールド	selected
   Implement java.io.Serializable Interface	selected
   Generate @NamedQuery Annotation to Retrieve All Instances	selected

   

8. ステップ7のSpecify Entity Detailsで、FOD.PRODUCTS_BASE表のデフォルトのエンティティ名とクラスを受け入れます。「Finish」をクリックします。

   

9. 「」Save Allをクリックして作業内容を保存します。
   
   表のエンティティの作成ステップが完了すると、Oracle JDeveloperによりEJBログ・ウィンドウにメッセージが表示されます。

   
プロジェクトのすべてのフォルダが展開されると、アプリケーション・ナビゲータは次のように表示されます。詳細表示



プロジェクトには、次のコンポーネントが含まれます。

• persistence.xml： JARファイルがJPA永続性アーカイブであると宣言するメタデータ・ファイルです。メタデータで、1つ以上の永続性ユニットが定義されます。アプリケーション・ナビゲータの「persistence.xml」を選択します。 Structureウィンドウで、Oracle JDeveloperにより自動的に生成されたデフォルトの永続性ユニットを確認します。

• ProductsBase.java： FODスキーマのPRODUCTS_BASE表を示すEJB-JPAエンティティです。

永続性ユニットは、配置されたプロジェクト（EJB JARファイルまたはWARファイル）に含まれているエンティティのサブセット（すべての場合もあります）を識別します。詳細表示また、メタデータとこのエンティティ・グループを関連づけます。これには、Java EEコンテナの内部または外部のどちらで実行されるかが含まれます。Javaサービス・ファサードは、JPAエンティティをラップし、問合せメソッドとトランザクション・メソッドを提供するJavaクラスです。IDEで、Create Java Service Facadeウィザードを使用して、Javaサービス・ファサードを迅速に生成できます。同じウィザードで、コンテナ外部で実行するために構成された新しい永続性ユニットも作成できます。

1. アプリケーション・ナビゲータで、Application Sourcesに続けてMETA-INFを展開し、persistence.xmlを右クリックします。そして、New Java Service Facadeを選択し、Create Java Service Facadeウィザードを立ち上げます。

   

2. ウィザードのステップ1であるJava Service Classで、Javaサービス・クラスの名前をproject1.ProductsJavaServiceFacadeに変更します。これは、別のJavaサービス・ファサードが生成される場合に変更を上書きしないようにするためです。

   

3. Generate a Sample Java Clientの選択を解除します。「Next」をクリックします。
   
   セッション・ファサードとは異なり、Javaサービス・ファサードはコンテナ内部で実行されないので、メソッドを呼び出すために別のサンプル・クライアントを作成する必要はありません。Javaサービス・クラスのmain()メソッドを追加して、独自のクライアントとしてJavaサービス・ファサードを使用できます。

4. ウィザードのステップ2であるCreate Persistence Unitで、永続性ユニット名にProject1-Outsideと入力します。 JDBC Connectionが選択され、作成したデータベース接続（例：FOD）がドロップダウン・リストで選択されていることを確認します。「Next」をクリックします。

   
この例では、同じエンティティのコンテナの外部で実行される永続性ユニットを作成します。詳細表示 前のステップでは、Create Entities from Tablesウィザードを使用してJPAエンティティを作成すると、Oracle JDeveloperによりpersistence.xmlファイルにデフォルトの永続性ユニットであるProject1が自動的に作成されました。Java EEコンテナ内部で実行できるように、デフォルトの永続性ユニットが構成されます。

同じエンティティを複数の永続性ユニットに表示できますが、それぞれ異なるマッピング動作が保持されます。表すエンティティ・クラスを定義する以外に、永続性ユニットは（デフォルトの接続を変更する際の）データソース情報と多くのプラットフォーム固有のプロパティも定義します。個別の永続性ユニットを作成する一般的な必要事項は、Java EEコンテナの内部と外部で同じエンティティを実行することです。

5. ステップ3のJava Service Facade Methodsで、両方のノードを展開してすべてのメソッドが選択されていることを確認します。次に、「Finish」をクリックします。

   
エンティティの下のメソッドは名前付き問合せで、エンティティを作成およびアップデートします。詳細表示 getEntitynameFindAll()メソッドとremoveEntityname()メソッド（Entitynameはエンティティの名前を示します）が、各エンティティにデフォルトで生成されます。エンティティに追加する名前のついた問合せを作成した場合も、このリストに表示されます。

6. 「」Save Allをクリックして作業内容を保存します。
   
   永続性ユニットとJavaサービス・ファサードの作成ステップが完了すると、IDEは次のように表示されます。
   
   
   
   Oracle JDeveloperにより、ProductsJavaServiceFacade.javaファイルがソース・エディタ内で開きます。Javaサービス・クラスには、ファサードでの公開を選択したメソッドが含まれます。

アプリケーション・ナビゲータで、persistence.xmlをダブルクリックして概要エディタのファイルを開くと、2つの永続性ユニットを確認できます。詳細表示



Sourceエディタ・タブをクリックしてXMLエディタに切り替えると、コンテナ外部で実行するために構成された新しい永続性ユニットを作成した場合にOracle JDeveloperで生成したコードを確認できます。
<persistence-unit name="Project1-Outside" transaction-type="RESOURCE_LOCAL">
  <provider>
    org.eclipse.persistence.jpa.PersistenceProvider
  </provider>
  <class>
    project1.ProductsBase
  </class>

  <properties>
    ...
  </properties>
</persistence-unit>

1. まだ開いていない場合は、アプリケーション・ナビゲータで「」ProductsJavaServiceFacade.javaをダブルクリックして、Javaソース・エディタで開きます。 実行可能なJavaサービス・ファサードを作成するには、main()メソッドを追加します。

   

2. ソース・エディタで、次のパブリック・メソッドの後に、製品名のリストをプリントアウトするmain()メソッドを追加します。
   
   public ProductsJavaServiceFacade(){...}
   
   次のコードをコピーアンドペーストします。

public static void main(String[] args) {
   final ProductsJavaServiceFacade productsJavaServiceFacade = new  ProductsJavaServiceFacade();
   List<ProductsBase> prodList =  productsJavaServiceFacade.getProductsBaseFindAll();
   for (ProductsBase prod : prodList) {
     System.out.println(prod.getProductName());
   }
}

3. アプリケーション・ナビゲータで、「」ProductsJavaServiceFacade.javaを右クリックし、「Run」を選択します。
   
   Runをクリックすると、JDeveloperは始めにプロジェクトを保存し、コンパイルします。 コンパイルの詳細がMessages Logウィンドウに表示されます。 Running Logウィンドウを開き、Java EEコンテナの外部で実行されるクラスの実行結果を確認します。そして、製品名のリストが返されます。
   
   

このチュートリアルでは、JPAエンティティやJava EEコンテナ外部で実行するシンプルなJavaサービス・ファサードを使用したJPAアプリケーションを構築します。このチュートリアルで学習した内容は、以下のとおりです。

• JDeveloperのウィザードおよびダイアログを使用してアプリケーションおよびデータベース接続を作成する。
• Java EEコンテナ外部で実行するために構成された永続性ユニットを生成します。
• ソース・エディタを使用して、main()メソッドにコードを追加します。
• Javaサービス・ファサードを実行します。

Java EEアプリケーションおよびJDeveloperの開発に関する詳細は、下記のWebサイトを参照してください。

• Creating a Simple EJB Session Bean
• Getting Started with the JDeveloper IDE
• User's Guide for Oracle JDeveloper
• Java EE Developer's Guide for Oracle ADF