このチュートリアルでは、 sakila という名前のMySQLデータベースを使用します。IDEのインストールにはサンプル・データベースが含まれていないため、このチュートリアルを開始する前に、まずデータベースを作成する必要があります。

Sakilaデータベースは、MySQLのサイトから入手できる、無料のMySQLサンプル・データベースです。sakilaデータベースを作成するには、プラグイン・マネージャを使用してSakilaサンプル・データベース・プラグインをダウンロードしてインストールできます。プラグインのインストール後、「サービス」ウィンドウからSakilaデータベースを作成できます。Sakilaデータベースは、「MySQLデータベースの作成」ダイアログ・ボックスのデータベース一覧に追加されます。

MySQLを操作するためのIDEの構成については、MySQLデータベースへの接続のチュートリアルを参照してください。

「OK」をクリックすると、「MySQLサーバー」ノードの下に「Sakila」ノードが表示されます。

「接続」をクリックすると、「Sakila」データベースのデータベース接続のノード( jdbc:mysql://localhost:3306/sakila [デフォルトの_ユーザー名_] )が「データベース」ノードに一覧表示されます。接続が開いたら、接続ノードを展開してデータベースのデータを表示できます。

この課題では、DVDStoreAdminという名前の単純なJava Swingアプリケーション・プロジェクトを作成します。

「終了」をクリックすると、IDEでJavaアプリケーション・プロジェクトが作成されます。このプロジェクトにはメイン・クラスが設定されていません。フォームを作成し、このフォームをメイン・クラスとして設定します。

HibernateサポートをJ2SEプロジェクトに追加するには、Hibernateライブラリをプロジェクトに追加する必要があります。HibernateライブラリはIDEに含まれており、「プロジェクト」ウィンドウで「ライブラリ」ノードを右クリックして「ライブラリの追加」を選択し、「ライブラリの追加」ダイアログ・ボックスで「Hibernate」ライブラリを選択することで、任意のプロジェクトに追加できます。

IDEには、プロジェクトに必要なHibernateファイルの作成に役立つウィザードが複数用意されています。IDEのウィザードを使用し、Hibernate構成ファイルとユーティリティ・ヘルパー・クラスを作成できます。ウィザードを使用してHibernate構成ファイルを作成すると、IDEでHibernateライブラリがプロジェクトに自動的に追加されます。

このチュートリアルでは、POJO (Plain Old Java Object)である Actor.java を使用してデータベース内のACTOR表のデータを表示します。このクラスは、表内の列のフィールドを指定し、データを取得および書込みするための単純な取得メソッドおよび設定メソッドを使用します。 Actor.java をACTOR表にマップするには、Hibernateのマッピング・ファイルを使用するか、クラスの注釈を使用します。

リバース・エンジニアリング・ウィザード、およびデータベースからのHibernateのマッピング・ファイルとPOJOウィザードを使用して、選択するデータベース表に基づいて複数のPOJOとマッピング・ファイルを作成できます。かわりに、IDEのウィザードを使用して個別のPOJOとマッピング・ファイルを最初から作成することもできます。

注意:

この課題では、データを入力および表示するためのフィールドを含む、単純なJFrameフォームを作成します。また、データを取得するためのデータベース問合せをトリガーするボタンを追加します。

GUIビルダーを使用したフォームの作成に慣れていない場合は、GUIビルドの概要のチュートリアルを見直すことをお薦めします。

IDEで、HQL問合せエディタを使用してHibernate問合せ言語(HQL)に基づく問合せを構築およびテストできます。問合せを入力すると、それに相当する(変換された) SQL問合せがエディタに表示されます。ツールバーの「HQL問合せの実行」ボタンをクリックすると、IDEが問合せを実行し、エディタ下部に結果が表示されます。

この課題では、HQLエディタを使用して、姓または名の一致に基づいて俳優の詳細リストを取得する、単純なHQL問合せを構築します。問合せをクラスに追加する前に、HQL問合せエディタを使用して、接続が正しく動作し、問合せで目的の結果が生成されることをテストします。この問合せを実行するには、まずアプリケーションをコンパイルする必要があります。

「HQL問合せの実行」をクリックすると、問合せ結果がHQL問合せエディタの下のペインに表示されるはずです。

問合せによって名前が「PE」で始まる俳優の詳細リストが返されます。

結果の上にある「SQL」ボタンをクリックすると、次のようなSQL問合せが表示されるはずです。

問合せによって姓が「MO」で始まる俳優の詳細リストが返されます。

問合せをテストすると、その問合せが目的の結果を返すことがわかります。次の手順では、フォームで「問合せ」ボタンをクリックすると適切な問合せが呼び出されるように、問合せをアプリケーションに実装します。

問合せをHQL問合せエディタのタブからファイルにコピーし、コードを変更できます。

このメソッドは、 executeHQLQuery() というメソッドをコールし、問合せ文字列をユーザーが入力した検索文字列と組み合せて問合せを作成します。

IDEで queryButtonActionPerformed メソッドが作成され、このメソッドがソース・ビューに表示されます。

フォームの保存後、プロジェクトを実行できます。

これでコーディングが終了したので、アプリケーションを起動できます。プロジェクトを実行する前に、プロジェクトのプロパティのダイアログ・ボックスでアプリケーションのメイン・クラスを指定する必要があります。メイン・クラスが指定されていない場合は、アプリケーションの初回起動時にメイン・クラスを設定するよう求められます。

または、「参照」ボタンをクリックし、ダイアログ・ボックスでメイン・クラスを選択できます。

検索文字列を「名」または「姓」テキスト・フィールドに入力し、「問合せ」をクリックして俳優を検索し、詳細を確認します。

IDEの「出力」ウィンドウを見ると、表示された結果を取得したSQL問合せを確認できます。

POJOは単純なJavaクラスのため、新規Javaクラス・ウィザードを使用してクラスを作成し、そのクラスをソース・エディタで編集して、必要なフィールド、取得メソッドおよび設定メソッドを追加できます。POJOの作成後、ウィザードを使用してHibernateマッピング・ファイルを作成し、そのクラスを表にマップしてマッピング情報を hibernate.cfg.xml に追加します。マッピング・ファイルを最初から作成する場合、XMLエディタでフィールドを列にマップする必要があります。

*注意:*この課題はオプションで、「データベースからのHibernateのマッピング・ファイルとPOJO」ウィザードを使用して作成したPOJOおよびマッピング・ファイルの作成方法を説明します。

「取得メソッドおよび設定メソッドの生成」ダイアログ・ボックスでは、キーボードの[↑]を使用して、選択した項目を「Actor」ノードまで移動してから、[Space]バーを押してActor内のすべてのフィールドを選択できます。

表のためのPOJOの作成後、 Actor.java のHibernateマッピング・ファイルを作成します。

「終了」をクリックすると、 Actor.hbm.xml Hibernateのマッピング・ファイルがソース・エディタで開きます。また、IDEでマッピング・リソースに対するエントリが hibernate.cfg.xml に自動的に追加されます。このエントリの詳細は、 hibernate.cfg.xml のデザイン・ビューで「マッピング」ノードを展開するか、またはXMLビューで表示できます。XMLビューの mapping エントリは、次のようになります。

エディタでコード補完を使用すると、マッピング・ファイルの変更時に値を補完できます。

注意: デフォルトでは、生成される class 要素には終了タグがあります。開始と終了の class 要素タグの間にプロパティ要素を追加する必要があるため、次の変更(太字で表示)を加えます。変更後、 class タグの間でコード補完を使用できます。

POJOとHibernateのマッピング・ファイルを個別に作成すると、アプリケーションをさらにカスタマイズするときに役立つ場合があります。

このチュートリアルに関するご意見をお寄せください

Swing GUIアプリケーションの作成に関する追加情報は、次のチュートリアルを参照してください。