Java アプリケーションでの Beans とデータのバインド

このチュートリアルでは、NetBeans IDE でサポートされている Java アプリケーションでの Beans Binding 機能とデータのバインド機能の概要を示します。

目次

• 概要: NetBeans IDE での Beans Binding
• プロパティー間のバインド
• カスタム Beans のバインド
• バインドプロパティーの詳細設定
• コンポーネントへのデータのバインド
• 特別なバインドプロパティー

このチュートリアルを完了するには、次のソフトウェアとリソースが必要です。

概要: NetBeans IDE での Beans Binding

Beans Binding ライブラリがリリースされるまで、UI コンポーネントをデータベースに接続したり、コンポーネントのプロパティーの値の同期を保ったりするのは面倒でした。たとえば、標準データベースのデータを JTable に表示するには、データベースと JTable の接続を処理するユーティリティークラスを手作業で作成する必要がありました。また、異なる Bean のプロパティーの値 (たとえば JTextField の値とビジュアル Bean のレンダリング) の同期を保つには、リスナーやイベントハンドラを手作業でコーディングする必要がありました。

Beans Binding ライブラリによって、このすべての処理が簡単になり、また標準化されます。どのコンポーネントのどのプロパティーを同期する必要があるのかを指定する数行のコードを記述するだけで、残りの処理は Beans Binding ライブラリによって実行されます。NetBeans IDE では、Beans Binding 機能は GUI ビルダーに統合されているので、アプリケーションの視覚的なデザインが完成したらすぐに動作をコーディングできます。

このチュートリアルでは、IDE での Beans Binding の主な機能について説明します。

プロパティー間のバインド

Beans Binding は、基本的にイベントリスナーやイベントハンドラをコーディングせずに Bean のプロパティーを接続する方法です。

Beans Binding の概念と IDE に用意されている機能を示すために、ユーザーがスライダを調整してテキストフィールド内の数値を変更できる簡単な例を使用します。

例を設定する

1. IDE で、「ファイル」>「新規プロジェクト」を選択します。
2. 「Java」カテゴリを選択し、「Java Application」テンプレートを選択します。「次へ」をクリックします。
3. ウィザードの「名前と場所」ページで、次の操作を行います。
   • プロジェクト名に「NumberSlider」と入力します。
   • 「ライブラリの格納用に専用フォルダを使用」チェックボックスは選択されていない状態のままにします。NetBeans IDE 6.0 にはこのオプションはありません。
   • 「主プロジェクトとして設定」チェックボックスがすでに選択されていることを確認します。
   • 「主クラスを作成」チェックボックスを選択解除します。

   

4. 「完了」をクリックしてウィザードを終了し、プロジェクトを設定します。
5. 「プロジェクト」ウィンドウで「NumberSlider」プロジェクトノードを右クリックし、「新規」>「JFrame フォーム」を選択します。

   「JFrame フォーム」が「新規」メニューにない場合は、「その他」を選択します。次に「新規ファイル」ウィザードで「Swing GUI フォーム」カテゴリを選択してから「JFrame フォーム」テンプレートを選択します。

6. ウィザードの「名前と場所」ページで、次の操作を行います。
   • クラス名に「NumberSliderFrame」と入力します。
   • パッケージ名に「numberslider」と入力します。

   

7. 「完了」をクリックしてウィザードを終了し、フォームを作成します。

   NumberSliderForm.java が編集領域にデザインモードで開きます。

8. パレットの「Swing コントロール」セクションからスライダコンポーネントをデザイン領域までドラッグします。「パレット」ウィンドウが開いていない場合は、「ウィンドウ」>「パレット」を選択します。
9. パレットから、テキストフィールドコンポーネントをデザイン領域までドラッグします。

   フォームは次のスクリーンショットのようになります。この例では、配置は重要ではありません。

   

カスタム Beans のバインド

前の節では、パレットからフォームに追加した 2 つの標準の Swing コンポーネントのプロパティーをバインドしました。ほかの Beans のプロパティーもバインドできます。ただし、これを行うには、いくつかの手順を実行して Bean のバインドコードを生成する IDE の機能を使用可能にする必要があります。次の方法のいずれかを行い、Bean 用に IDE のバインド機能を使用可能にできます。

• Bean をパレットに追加し、標準の Swing コンポーネントと同じようにフォームに追加できるようにします。
• Bean クラスをプロジェクトに追加し、Bean をコンパイルします。

「パレット」ウィンドウに Bean を追加する

1. Bean がコンパイルされていることを確認します。
2. 「ツール」>「パレット」>「Swing/AWT コンポーネント」を順に選択します。
3. Bean の新規パレットカテゴリを作成する場合は、Bean を追加する前に「新規カテゴリ」をクリックし、使用する名前を入力します。
4. 「JAR から追加」、「ライブラリから追加」、または「プロジェクトから追加」をクリックし、ウィザードを完了して Bean を追加します。

プロジェクトから Bean を追加する

1. プロジェクトのウィンドウで Bean のノードを右クリックし、「ファイルをコンパイル」を選択します。
2. Bean をフォームまでドラッグします。

   すると、Bean が「インスペクタ」ウィンドウに表示されます。Bean の任意のプロパティーの「バインド」ダイアログを開くことができます。

バインドの詳細設定

このチュートリアルの最初の節の例では、デフォルト動作の一部分を使用した簡単なバインド方法を示します。実際には、バインドの設定を変更する必要がある場合があります。その場合は、「バインド」ダイアログの「詳細」タブを使用できます。

このダイアログの「詳細」タブには、次のフィールドがあります。

• 名前。バインドの名前を作成できます。これにより、バインドをより柔軟に管理できます。名前はバインドのコンストラクタに追加され、バインドの getName() メソッドで参照できます。
• モードを更新。プロパティーの同期の維持方法を指定します。可能な値は次のとおりです。
  • 常に同期 (読み取り/書き込み)。ソースまたはターゲットのいずれかに変更が行われると、もう一方が更新されます。
  • ソースから読み取りのみ (読み取り専用)。最初にソースの値が設定されたときのみターゲットが更新されます。ソースに変更を行うと、ターゲットも更新されます。ターゲットに変更を行なっても、ソースは更新されません。
  • ソースから一度読み取り (一度読み取り)。ターゲットとソースが最初にバインドされたときのみターゲットが更新されます。
• ソースの更新時期 (JTextField および JTextArea コンポーネントの text プロパティーでのみ使用可能)。プロパティーを同期する頻度を選択できます。
• 調整を無視 (JSlider の「value」プロパティー、JTable および JList の「selectedElement」プロパティー、JTable および JList の「selectedElements」プロパティーでのみ使用可能)。このチェックボックスを選択すると、あるプロパティーに対して行われた変更は、ユーザーが変更を完了するまで、もう一方のプロパティーに反映されません。たとえば、アプリケーションのユーザーがスライダを移動させた場合、スライダの「value」プロパティーがバインドされたプロパティーの値は、ユーザーがマウスのボタンを離すまで更新されません。
• コンバータ。バインドされたプロパティーに異なる型のデータが含まれる場合、それぞれの型の間で値を変換するコードを指定できます。Beans Binding ライブラリでは一般的な変換の多くを処理できますが、それ以外のプロパティーの型の組み合わせが存在する場合は、独自のコンバータが必要な場合もあります。このようなコンバータは、org.jdesktop.beansbinding.Converter クラスを拡張する必要があります。

  「コンバータ」ドロップダウンリストには、フォームに Bean として追加されたコンバータが含まれています。また、省略符号ボタン (...) をクリックし、「コンバータプロパティーの使用方法を選択」ドロップダウンリストから「カスタムコード」を選択して、変換コードを直接追加することもできます。

  次の変換では、コンバータを用意する必要はありません。

  • BigDecimal から String へ、String から BigDecimal へ
  • BigInteger から String へ、String から BigInteger へ
  • Boolean から String へ、String から Boolean へ
  • Byte から String へ、String から Byte へ
  • Char から String へ、String から Char へ
  • Double から String へ、String から Double へ
  • Float から String へ、String から Float へ
  • Int から String へ、String から Int へ
  • Long から String へ、String から BigDecimal へ
  • Short から String へ、String から Short へ
  • Int から Boolean へ、Boolean から Int へ
• バリデータ。変更をソースプロパティーに反映させる前に、ターゲットプロパティー値の変更内容の妥当性検査を行うためのコードを指定できます。たとえば、整数のプロパティー値が特定の範囲内になるようにバリデータを使用できます。

  バリデータは、org.jdesktop.beansbinding.Validator クラスを拡張する必要があります。
  「バリデータ」ドロップダウンリストには、フォームにBean として追加されたバリデータが含まれています。また、省略符号ボタン (...) をクリックし、「バリデータプロパティーの使用方法を選択」ドロップダウンリストから「カスタムコード」を選択して、妥当性検査のコードを直接追加することもできます。

• ソースの値が NULL。バインドの試行時にソースプロパティーの値が Null の場合、異なる値を使用するよう指定できます。このフィールドは、org.jdesktop.beansbinding.Binding クラスの setSourceNullValue() メソッドに対応します。
• 読み取り不能なソース値。バインドの試行時にバインド式が解決できない場合、異なる値を使用するよう指定できます。このフィールドは、org.jdesktop.beansbinding.Binding クラスの setSourceUnreadableValue() メソッドに対応します。

注: 前述のクラスやメソッドについて詳しく理解するには、IDE から Beans Binding に関する Javadoc ドキュメントに直接アクセスしてください。「ヘルプ」>「Javadoc 参照」>「Beans Binding」を選択します。開かれたブラウザウィンドウで、「org.jdesktop.beansbinding」リンクをクリックし、これらのクラスのドキュメントにアクセスします。

コンポーネントへのデータのバインド

ビジュアル Swing コンポーネントとその他のカスタム Beans のプロパティーを同期するほか、ビジュアルコンポーネントを使用してデータベースと対話するために Beans Binding を使用できます。新しい Java フォームを作成し、コンポーネントをフォームに追加したら、それらのコンポーネントをデータにバインドするためのコードを生成できます。この節では、Swing JTable、JList、および JComboBox の各コンポーネントにデータをバインドする方法を示します。

コンポーネントをデータベース内のデータにバインドする前に、次の作業が行われている必要があります。

• IDE でデータベースに接続している。
• バインドするデータベース表を表すクラスを作成している。データをコンポーネントにバインドするためのエンティティークラスの作成手順は次のとおりです。

jComboBox1.setRenderer(new DefaultListCellRenderer() {
           @Override
           public Component getListCellRendererComponent(
                   JList list, Object value, int index, boolean isSelected, boolean cellHasFocus) {
               super.getListCellRendererComponent(list, value, index, isSelected, cellHasFocus);
               if (value instanceof MyEntityClass) {
                   MyEntityClass mec = (MyEntityClass)value;
                   setText(mec.getPropertyFromMyEntityClass());
               }
               return this;
           }
            })

特別なバインドプロパティー

Beans Binding ライブラリは一部の Swing コンポーネントに対し、必要に応じてコンポーネント自身に存在しない特別な合成プロパティーを提供します。これらのプロパティーは、表で選択されている行などの内容を表すもので、ほかのプロパティーにバインドするのに役立ちます。

Beans のバインドライブラリによって追加される合成プロパティーには、次のものがあります。

関連項目

IDE での Beans Binding の使用方法の詳細については、JPA と Beans Binding のベストプラクティスを参照してください。

IDE の GUI ビルダーの一般的な使用方法については、GUI 構築入門を参照してください。

Beans Binding の詳細については、java.net にある Beans Binding プロジェクトのページを参照してください。

JavaBeans コンポーネントの概要については、Java Tutorial の Beans Trail を参照してください。

NetBeans IDE の GUI ビルダーを使用する際のヒントについては、GUI エディタの FAQ を参照してください。