| Oracle® Fusion Middleware Oracle Application Development Framework Swingアプリケーションの開発 12c (12.1.3) E59440-01 |
|
 前 |
 次 |
| Oracle® Fusion Middleware Oracle Application Development Framework Swingアプリケーションの開発 12c (12.1.3) E59440-01 |
|
前 |
次 |
この章では、デザインタイム・ウィザードを使用してADF Swingフォームおよびパネルを作成する方法について説明します。このウィザードは、ビジネス・サービス・データ・コレクションにバインドされている標準のJFC/Swingコンポーネントを使用し、JavaによってADF Swingフォームを表示するUIクライアントを構築する際に役立ちます。
この章の内容は次のとおりです。
データ参照パネルには、ユーザーがデータを表示および編集できるコントロールが表示されます。したがって、それには、フィールドとして宣言されてインスタンス化されたコントロールのセットが含まれています。データ参照パネルは、次のように(setBindingContext()コールを介して)親フレームまたはパネルからそのパネル・バインディングを受け取ります。
panel.setBindingContext(panelBinding.getBindingContext());
親コンテナによって、データ参照パネルおよびそのパネル・バインディングが作成された後、jbInit()が呼び出されます。jbInit()メソッド内で、コントロールが属性にバインドされます。
例2-1では、textFieldDeptNameは、基礎となるビジネス・サービスのDepartmentName属性にバインドされているJTextFieldコンポーネントであり、識別子DepartmentNameは、PageDef.xmlファイル内の定義への参照です(このファイルによってバインディング・コンテナが定義されます)。バインディング・コンテナは、イテレータ・バインディングのリストを保持します。各イテレータ・バインディングは、ビュー・オブジェクト・インスタンスおよび(オプションの)行セット・イテレータを指定します。
例2-1 DepartmentName属性にバインドされたJTextFieldコンポーネント
textFieldDeptName.setDocument((Document)panelBinding.bindUIControl
("DepartmentName", textFieldDeptName));
実行時に、setDocument()が呼び出されると、ADF Swingが、指定されている名前(DepartmentName)によってコントロール・バインディングを見つけます。そのフォームのバインディング・コンテキストでそれが見つかると、ADF Swingは、そのコントロール・バインディングの関連付けられたイテレータ・バインディングを使用して、その値にアクセスします。
機能的には、ADF Swingは、デザインタイムとランタイムに分かれています。デザインタイムは、一連のウィザードおよびダイアログを通してJDeveloper IDEと完全に統合されており、JDeveloperを使用してADF Swingアプリケーションをすばやく生成できます。ADF Swingデザインタイムは、ADF Swingランタイムへのフックが含まれたコードを生成します。
ADF Swingウィザードおよびダイアログは、ADF SwingランタイムAPIの完全なコマンドなしで使用できます。デザインタイムは、ビジネス・サービス・データ・コレクションにバインドされている標準のJFC/Swingコンポーネントを使用して、ADF Swingフォームを表示するデスクトップ・アプリケーションを構築する際に役立ちます。ADF Swingデザインタイムを使用し、標準Swingコントロールに追加するコントロール・バインディングによって、ADF Swingフォームで、ビジネス・コンポーネント上の値を取得および設定できます。
次リストのADF Swingウィザードおよびダイアログは、JDeveloper IDEとともに、ADF Swingアプリケーションまたはアプレットをすばやく構築、実行およびテストするために役立ちます。後で、より高度なコントロールおよびJavaコードを追加してアプリケーションを拡張することで、ADF Swingフォームを変更できます。
ADF Swingフォームの作成
ADF Swingパネルの作成
ADF Swingの空のフォームの作成
ADF Swingの空のパネルを作成
Java Web Startファイルの作成
ADF Swingフォームがクライアント・マシンにデプロイされている場合、ユーザーはそれを使用してフォーム内のデータを表示および操作できます。図2-1に、フレーム・ウィンドウに表示されているADF Swingフォームの例を示します。
フォームの上部にはメニュー・バーがあります。メニュー・バーの下には、マスター表のデータのナビゲーションを制御するナビゲーション・バーがあります。フォームの下部にあるナビゲーション・バーで、ユーザーは、ディテール表を移動および相互作用できます。
この例では、マスター表はOrders表です。いくつかのデータバインドされたテキスト・フィールド・コントロールは、Orders表の列を表し、ORDER_ID、ORDER_DATE、ORDER_SHIPPED_DATEおよびORDER_TOTALを表示します。このフォームは、データバインドされたグリッド・コントロールを使用して、ディテールOrderItems表のデータを表示します。
データが「Order Id」フィールドに入力されると、ADF Swingフォームは、Orders表とOrderItems表の間のマスター/ディテール・アソシエーションを使用して、グリッド・コントロールに表示されるデータを見つけます。グリッド・コントロールに表示されるディテール表の列は、ORDER_ID、PRODUCT_ID、QUANTITYおよびUNIT_PRICEです。これで、フォームに表示されるデータに関するステータスを表示するステータス・バーがフォームに含まれるようになります。
表2-1は、ADF Swingフォームと相互作用するためにナビゲーション・バーを使用して実行できるアクションを示しています。
ADF SwingアプリケーションのADF Swingパネルおよびフォームを作成する手順は、他のADFクライアント・テクノロジを使用してユーザー・インタフェースを作成する手順に似ています。主な違いは、コントローラに基づいたページ・フローを作成しないことと、ADF SwingウィザードなどいくつかのADF Swing固有の編集ツールがあることです。
アプリケーション・ワークスペースを作成し、「ADF Javaデスクトップ・アプリケーション」アプリケーション・テンプレートを選択します。
詳細は、第1.2項「Oracle ADFと連携するデスクトップ・アプリケーションの作成」を参照してください。
ビジネス・コンポーネントのデータ・モデル・プロジェクトを作成します。
ADF Swingパネルまたはフォームをユーザー・インタフェース・プロジェクトに追加します。これを実行する方法はいくつかあります。
空のADF Swingフォームをユーザー・インタフェース・プロジェクトに追加します。
詳細は、第2.9項「空のADF Swingフォームの作成方法」を参照してください。
ADFビジネス・コンポーネント・プロジェクトを作成します。
ADFビジネス・コンポーネントを使用している場合、選択したビュー・オブジェクトおよび属性にすでにバインドされているADF Swingフォームを追加できます。
詳細は、第2.1.1項「ADF Swingデザインタイム・ウィザード」を参照してください。
ADFビジネス・コンポーネントを使用している場合、ビュー・オブジェクトおよび属性にすでにバインドされているADF Swingパネルを、ユーザー・インタフェース・プロジェクトに追加できます。
Javaビジュアル・エディタでフォームまたはパネルを開きます。
「コンポーネント」ウィンドウを使用して、データバインドされないSwingコントロール(たとえば、JScrollPaneなどのレイアウト・コンポーネント)を挿入します。
「データ・コントロール」パネルを使用して、データバインドされたUIコンポーネントをADF Swingフレームまたはパネルに挿入します。
「構造」ウィンドウを使用して、ページのUIコンポーネントとデータ・バインディングを参照します。
「プロパティ」ウィンドウを使用して、ページのUIコンポーネントとデータ・バインディングの属性を変更します。
ADFバインディング・エディタを使用して、バインドされたコントロールの特性を変更します。
すべての編集が完了したら、ユーザー・インタフェース・プロジェクトを構築します。
JDeveloperを使用してアプリケーションを実行するかデバッグします。
ユーザー・インタフェース・プロジェクトをデバッグしたら、JDeveloperの統合WebLogic ServerおよびJava Web Startアプリケーション・デプロイメント・テクノロジを使用してデプロイメントをテストできます。Java Web Startによって、ユーザーはWebブラウザを使用してアプリケーションおよびアプレットをダウンロードでき、そのアプリケーションはWebブラウザを必要とせずにクライアント上で完全に実行されます。
詳細は、http://www.oracle.com/technetwork/java/javase/overview-137531.htmlを参照してください。
生成されたWeb Application Archive (WAR)ファイルを使用して本番Webサーバーに本番ADF Swingアプリケーションおよびビジネス・サービスをデプロイします。
クライアント・マシンにインストールされているJava Web Startで、ユーザーは、アプリケーションを簡単にダウンロードおよび起動できます。Webサーバー上のアプリケーションに対して行われた更新は、Java Web Startによって、ユーザーがそのアプリケーションを起動するたびに処理されます。
ADF Swingフォームの作成ウィザードを使用して、ADFビジネス・コンポーネント・データ・モデルに基づいたマスターおよびディテール・パネルを使用するADF Swingアプリケーションを生成すると、ウィザードによってADF Swingフレーム内にコンテナ・パネルが生成されます。このパネルは、いくつかのデータ・パネルをひとまとめにグルーブ化するため、レイアウト・パネルと呼ばれます。レイアウト・パネルは、1つ以上のデータ参照パネル用のUIコンテナとして機能するだけでなく、その共有バインディング・コンテキストを通して、含まれているデータ・パネルに対するデータ・コンテキストを保持できます。
|
注意: レイアウト・パネルは、ADF Swingフォームの作成ウィザードによって生成されますが、ADF Swingアプリケーションの必須の部分ではありません。ここでそれについて説明するのは、主に、ADF Swingアプリケーションが、共有バインディング・コンテキストを通してデータ参照パネル間のデータ・コンテキストを保持する方法を示すためです。 |
アプリケーション・フレームからのバインディング・コンテキストは、例2-2に示すように、そのパネルのsetBindingContext()メソッドへのコールによって、それに含まれているADF Swingパネルに渡すことができます。
例2-2 ADF Swingパネルへのバインディング・コンテキストの受渡し
// get the binding context from the frame BindingContext _bctx = panelBinding.getBindingContext(); // pass the context to the first child panel dataPanel.setBindingContext(_bctx); //alternatively you can use dataPanel.setBindingContext(panelBinding.getBindingContext());
「新規ギャラリ」の「ADF Swing」セクションでADF Swingウィザードを実行すると、ウィザードを使用して次のものを生成できます。
複数のADF Swingフォームで構成された完全なデータバインドされたSwingアプリケーション
自身のデータバインドされたSwingアプリケーションの作成に使用できる個々のADF Swingフォーム
データバインドされたSwingコンポーネントを追加するために使用できる空のADF Swingフォーム
このウィザードによって、データを表示するための標準Swingコンポーネントが含まれているADF Swingフォームが生成されます。ADF Swingウィザードの1つを実行する前に、コード生成がこれらのコンポーネントに対して機能する方法の局面を変更できます。特に、「プリファレンス」ダイアログのADF Swingページでコード生成オプションを選択できます。
次のことを指定できます。
Javaビジュアル・エディタは、新しいフォームまたはデータ・パネルを作成するたびに開く。
ユーザー・インタフェース・プロジェクトは、指定した追加のインポート文で構築する。
ユーザー・インタフェース・プロジェクトは、追加のライブラリで構築する(たとえば、独自のフォーム・コンポーネントを使用する必要がある場合など)。この場合、カスタム・コンポーネントを追加しておき、空のADF Swingフォームから始めてADF Swingフォームを作成することを選択できます。
ADF Swingフォームの作成ウィザードおよびADF Swingパネルの作成ウィザードで、標準Swingコンポーネントまたは独自のカスタム実装を使用するフォームを生成する。現在、ADF Swingフォームに表示されるナビゲーション・バー、ステータス・バー、テキスト・フィールドおよびテキスト・エリアのコンポーネントを置換できます。
ADF Swingフォームの作成ウィザードで、複数のデータ・パネルが含まれるフォーム(たとえば、マスター/ディテール・フォーム)に1つのナビゲーション・バーを生成する。通常、ウィザードでは、各データ・パネルを、それ自体のナビゲーション・バーとともに作成します。ナビゲーション・バーが1つのみのフォームを作成すると、ビジュアル的に整って見えますが、目的の行セットに移動するためには、ユーザーはデータ・パネル間でフォーカスを変更する必要があります。
データ・モデル・プロジェクトで、個々のビュー・オブジェクト属性に関する次のフラグを設定することによって、フォームでの特定の属性の問合せまたは編集を可能にするかどうかを指定できます。
問合せ可能
表示されている属性を、ユーザーが検索モードのフォームで開始する問合せで指定できないようにすることができます。ビュー・オブジェクト概要エディタを開き、その属性の属性詳細パネルで「問合せ可能」を選択解除します。
更新可能
表示されている属性をユーザーが編集できないようにします。ビュー・オブジェクト概要エディタを開き、その属性の属性詳細パネルで更新不可を選択します。
ADF Swingアプリケーションには、ADFビジネス・コンポーネント・ビュー・オブジェクトに接続するためにクライアント・データ・モデル定義が必要です。ADFビジネス・コンポーネント・クライアント・データ・モデル定義の作成ウィザードを使用して、1つ以上のクライアント・データ・モデル定義をDataBindings.cpxユーザー・インタフェース構成ファイルに追加します。
|
注意: JDeveloperによって、最近保存されたデータ・モデル定義に基づいていくつかのアプリケーション・ライブラリが更新されます。データ・モデル定義を作成または編集するが、異なるデータ・モデル定義でプロジェクトを実行する場合は、次の説明のように目的のデータ・モデル定義をADFビジネス・コンポーネント・クライアント・データ・モデル定義の作成ウィザードで開き、それを保存する必要があります。このアクションによって、適切なクラスが生成されます。 |
作業を始める前に、次のようにします。
次のタスクを完了する必要があります。
ビジネス・コンポーネントのデータ・モデル・プロジェクトを作成します。
クライアント・データ・モデルを定義するには、最初にADFビジネス・コンポーネント・アプリケーション・モジュールでプロジェクトを作成する必要があります。
データ・モデル・プロジェクトをコンパイルします。
新しいユーザー・インタフェース・プロジェクトに対するクライアント・データ・モデル定義を作成する手順は次のとおりです。
「アプリケーション」ウィンドウで、ユーザー・インタフェース・プロジェクトを選択し、メイン・メニューから「ファイル」→「新規」→「ギャラリから」を選択します。
ADF Swingフォーム・ウィザードおよびADF Swingパネル・ウィザード内でADFビジネス・コンポーネント・クライアント・データ・モデル定義ウィザードを起動する必要があります。
「新規ギャラリ」で、「クライアント層」→「ADF Swing」を選択し、「フォーム」または「パネル」をダブルクリックします。
新しいフォームまたはパネルのウィザードの「データ・モデル」ページで、「新規」をクリックします。
かわりに、起動したADF Swingウィザードを完了して、フォームまたはパネルを作成することもできます。また、生成したフォームまたはパネルをプロジェクトで使用しない場合は、それらを削除できます。新しいDataBindings.cpx構成ファイルは残ります。
ADFビジネス・コンポーネント・クライアント・データ・モデル定義ウィザードで、目的のアプリケーション・モジュールおよびランタイム構成を選択します。
「終了」をクリックし、変更を新しいDataBindings.cpx構成ファイルに保存します。
既存のユーザー・インタフェース・プロジェクトで、クライアント・データ・モデル定義を編集する手順は次のとおりです。
「アプリケーション」ウィンドウで、ユーザー・インタフェース・プロジェクトを開き、DataBindings.cpx構成ファイルを選択します。
メイン・メニューから、「ウィンドウ」→「構造」を選択します。
「構造」ウィンドウで、dataControlUsagesを開き、変更するデータ・コントロール定義を選択します。
必要に応じて、データ・コントロール・ノードを右クリックし、「削除」を選択します。
「プロパティ」ウィンドウで、データ・コントロール属性を編集します。
ADF Swingフォームの作成ウィザードを使用して、既存のADFビジネス・コンポーネント・プロジェクトのデータ・モデルから導出した単一表フォームを作成します。
作業を始める前に、次のようにします。
次のタスクを完了する必要があります。
ビジネス・コンポーネントのデータ・モデル・プロジェクトを作成します。
ADF Swingフォームでビジネス・コンポーネントを使用するには、最初にADFビジネス・コンポーネント・アプリケーション・モジュールでプロジェクトを作成する必要があります。
データ・モデル・プロジェクトをコンパイルします。
単一表のADF Swingフォームを持つユーザー・インタフェース・プロジェクトを作成する手順は次のとおりです。
「アプリケーション」ウィンドウで、ユーザー・インタフェース・プロジェクトを選択し、メイン・メニューから「ファイル」→「新規」→「ギャラリから」を選択します。
「新規ギャラリ」で、「クライアント層」→「ADF Swing」を開き、「フォーム」をダブルクリックします。
ADF Swingフォームの作成ウィザードの「フォームのタイプ」ページに、アプリケーションで使用するために事前に選択されているADF Swingフォームのタイプ「フォーム」が表示されます。
アプレットを作成する場合は、タイプ「アプレット」を選択します。
「フォームのタイプ」ページで、「単一表」を選択し、「次へ」をクリックします。
選択を行ってフォームの外観を定義します。
「データ・モデル」ページで、既存のデータ・モデル定義を選択するか、「新規」をクリックして開発対象のアプリケーション・モジュールを指定するデータ・モデル定義を作成します。
「次へ」をクリックします。
残りのページでは、フォームに表示されるデータを指定するための適切な選択を行います。
「終了」をクリックします。
マスター/ディテール関係は、ADFビジネス・コンポーネントのデータ・モデルに定義されている2つ以上のビュー・オブジェクト間のアソシエーションです。これらのアスター/ディテール関係に依存するADF Swingフォームを生成できます。マスター・フォームの値によって、どのディテール・レコードが表示されるのかが決定されます。
ADFビジネス・コンポーネント・データ・モデル内で定義できるマスター・ディテール関係のタイプは次のとおりです。
マスター・フォームからディテール・フォーム
マスター・フォームから複数のディテール・フォーム
マスター/ディテール関係のカスケード(マスター/ディテール/ディテール・フォーム)
このタイプのADF Swingフォームを生成する最も簡単な方法は、ADF Swingフォーム・ウィザードを起動し、ウィザード内で「マスター/ディテール表」を選択することです。ウィザードを終了すると、プロジェクトに次のものが含まれるようになります。
ADF Swingブートストラップ・コードが含まれているメイン・フレーム
マスター・ビュー・オブジェクト・データを表示するマスター・データ・パネル
ディテール・ビュー・オブジェクト・データを表示するディテール・データ・パネル
個々のマスターおよびディテール・データ・パネルの親として使用されるマスター/ディテール・データ・パネル
デフォルトでは、両方のデータ・パネルに、それぞれのナビゲーション・バーが表示されます。マスター・データ・パネルに表示されるナビゲーション・バーで、ユーザーは、付随する詳細を詳細パネルに表示しながら、マスター行セットの行から行へ移動できます。また、ユーザーは、詳細データ・パネルを移動し、現在のマスターにバインドされている個々の行を表示できます。
「プリファレンス」ダイアログでADF Swingコード生成プリファレンスを設定することで、ADF Swingフォーム・ウィザードに強制的に単一ナビゲーション・バーを持つマスター/ディテール・フォームを生成させることができます。ナビゲーション・バーが1つのみのADF Swingフォームを作成すると、ビジュアル的に整って見えますが、行セットに移動するためには、ユーザーはデータ・パネル間でフォーカスを変更する必要があります。
ADF Swingフォームの作成ウィザードを使用して、既存のADFビジネス・コンポーネント・プロジェクトのデータ・モデルから導出したマスター/ディテール・フォームを作成します。
作業を始める前に、次のようにします。
次のタスクを完了する必要があります。
ビジネス・コンポーネントのデータ・モデル・プロジェクトを作成します。
ADF Swingフォームでビジネス・コンポーネントを使用するには、最初にADFビジネス・コンポーネント・アプリケーション・モジュールでプロジェクトを作成する必要があります。
データ・モデル・プロジェクトをコンパイルします。
単一表のADF Swingフォームを持つユーザー・インタフェース・プロジェクトを作成する手順は次のとおりです。
「アプリケーション」ウィンドウで、ユーザー・インタフェース・プロジェクトを選択し、メイン・メニューから「ファイル」→「新規」→「ギャラリから」を選択します。
「新規ギャラリ」で、「クライアント層」→「ADF Swing」を開き、「フォーム」をダブルクリックします。
ADF Swingフォームの作成ウィザードの「フォームのタイプ」ページに、アプリケーションで使用するために事前に選択されているADF Swingフォームのタイプ「フォーム」が表示されます。
アプレットを作成する場合は、タイプ「アプレット」を選択します。
「マスター/ディテール表」を選択し、「次へ」をクリックします。
選択を行ってフォームの外観を定義します。
「データ・モデル」ページで、既存のデータ・モデル定義を選択するか、「新規」をクリックして開発対象のアプリケーション・モジュールを指定するデータ・モデル定義を作成します。
「次へ」をクリックします。
残りのページでは、フォームに表示されるデータを指定するための適切な選択を行います。
「終了」をクリックします。
「ADF Swingの空のフォームの作成」ダイアログを使用して、既存のデータ・モデル・プロジェクトのビジネス・コンポーネントからのパネル・バインディングを共有するADF Swingコードが含まれているフレームを作成します。
作業を始める前に、次のようにします。
次のタスクを完了する必要があります。
ビジネス・コンポーネントのデータ・モデル・プロジェクトを作成します。
ADF Swingフォームでビジネス・コンポーネントを使用するには、最初にビジネス・サービスの実装(たとえば、ADFビジネス・コンポーネント・アプリケーション・モジュール)でプロジェクトを作成する必要があります。
データ・モデル・プロジェクトをコンパイルします。
空のフォームを持つユーザー・インタフェース・プロジェクトを作成する手順は次のとおりです。
「アプリケーション」ウィンドウで、ユーザー・インタフェース・プロジェクトを選択し、メイン・メニューから「ファイル」→「新規」→「ギャラリから」を選択します。
「新規ギャラリ」で、「クライアント層」→「ADF Swing」を開き、「空のフォーム」をダブルクリックします。
「ADF Swingの空のフォームの作成」ダイアログで、空のフォームを定義し、「OK」をクリックします。
続いて、新しい空のフォームにデータ・パネルおよびデータバインドされたコントロールを追加できます。
詳細は、第3.3項「ADF SwingパネルへのUIコンポーネントの挿入方法」を参照してください。
ADF Swingパネルの作成ウィザードまたは「ADF Swingの空のパネルを作成」ダイアログを使用して、データ・パネルをすばやく作成できます。ADF Swingパネルの作成ウィザードで、アプリケーション内のフレームに追加できる完全なデータ・パネルを生成できますが、ADF Swingの空のパネルダイアログには、コントロール・バインディングが含まれていません。どちらのウィザードでも、ADF Swingパネル・バインディングの初期化に必要なコードが生成されます。
ユーザー・インタフェース・プロジェクトに新しいパネル・クラスを追加した後、既存のADF Swingフォームまたはパネルからパネルを追加できます。
作業を始める前に、次のようにします。
次のタスクを完了する必要があります。
ビジネス・コンポーネントのデータ・モデル・プロジェクトを作成します。
ADF Swingフォームでビジネス・コンポーネントを使用するには、最初にADFビジネス・コンポーネント・アプリケーション・モジュールでプロジェクトを作成する必要があります。
データ・モデル・プロジェクトをコンパイルします。
ADF Swingパネルの作成ウィザードを使用して単一表データ・パネルを追加する手順は次のとおりです。
「アプリケーション」ウィンドウで、ユーザー・インタフェース・プロジェクトを選択し、メイン・メニューから「ファイル」→「新規」→「ギャラリから」を選択します。
「新規ギャラリ」で、「クライアント層」→「ADF Swing」を開き、「パネル」をダブルクリックします。
ADF Swingパネルの作成ウィザードで、パネル・コンポーネントをレイアウトするテンプレートを選択します。
「データ・モデル」ページで、既存のデータ・モデル定義を選択するか、「新規」をクリックして開発対象のアプリケーション・モジュールを指定するデータ・モデル定義を作成します。
残りのページでは、フォームに表示されるデータを指定するための適切な選択を行います。
「終了」をクリックします。
ADF Swing空のパネルダイアログを使用してADF Swingデータ・パネルを追加する手順は次のとおりです。
「アプリケーション」ウィンドウで、ユーザー・インタフェース・プロジェクトを選択し、メイン・メニューから「ファイル」→「新規」→「ギャラリから」を選択します。
「新規ギャラリ」で、「クライアント層」→「ADF Swing」を開き、「空のパネル」をダブルクリックします。
「ADF Swingの空のパネルを作成」ダイアログで、新しい空のデータ・パネルのクラス名を入力し、「OK」をクリックします。
Javaビジュアル・エディタで新しいパネル・クラスを開き、コントロールを追加できます。
詳細は、第3.3項「ADF SwingパネルへのUIコンポーネントの挿入方法」を参照してください。
完成したADF Swingデータ・パネルをアプリケーションとリンクする手順は次のとおりです。
新しいADF Swingデータ・パネルを作成した後、次のようにして、アプリケーション内のデータ・パネルを再利用できます。
それを既存のレイアウト・パネル(たとえば、メインADF Swingフレームで作成したもの)に追加する。
詳細は、第3.6項「空のADF Swingフォームにデータ・パネルをドロップする方法」を参照してください。
ADF Swingの空のフォームウィザードを使用してADF Swingフレームを作成し、それをそこで追加する。
詳細は、第3.6項「空のADF Swingフォームにデータ・パネルをドロップする方法」を参照してください。
「データ・コントロール」パネルを使用して、選択したコントロールを使用した表示されている値の編集を可能にするデータバインドされたフォームを作成できます。このフォームは、選択するデータ・コレクションのオブジェクトに対して作成されます。
|
注意: 「データ・コントロール」パネルは、最初にそれを開いたときは空で表示されることがあります。データ・モデル・プロジェクトをコンパイルし、そのパネルにデータ・オブジェクトを移入します。 |
作業を始める前に、次のようにします。
次のタスクを完了する必要があります。
ビジネス・コンポーネントのデータ・モデル・プロジェクトを作成します。
ADF Swingフォームでビジネス・コンポーネントを使用するには、最初にADFビジネス・コンポーネント・アプリケーション・モジュールでプロジェクトを作成する必要があります。
データ・モデル・プロジェクトをコンパイルします。
データ・モデル・プロジェクトで、そのビジネス・サービスとしてADFビジネス・コンポーネントを使用している場合、JDeveloperによってそのビジネス・サービスがADFデータ・コントロールとして登録されます。
Javaビジュアル・エディタで既存のパネルに編集可能フォームを作成する手順は次のとおりです。
ウィザードを使用して空のADF Swingフォームまたはパネルを作成します。
詳細は、第2.2項「ADF Swingパネルおよびフォームの作成手順」を参照してください。
Javaビジュアル・エディタでフォームを開き、「設計」タブをクリックします。
「アプリケーション」ウィンドウで、「データ・コントロール」ヘッダーの拡張アイコンをクリックします。
「データ・コントロール」パネルで、目的のデータ・コレクションを、開いているフォームまたはパネルにドラッグします。
ポップアップ・リストから編集フォームの追加を選択します。
「ADF Swing編集フォームの作成」ダイアログで、表示したくない属性を選択し、「削除」ボタンをクリックします。
必要に応じて、属性を選択し、上または下矢印をクリックし、フォーム内でのその属性の表示位置を変更します。
必要に応じて、「制御」ドロップダウンを選択し、属性値を表示するコントロールを選択します。
必要に応じて、ラベルを表示しない場合は属性に対して「ラベルの作成」を選択解除します。
デフォルトでは、表示ラベルに属性IDが使用されます。また、ビジネス・オブジェクト属性に対してコントロール・ヒント・ラベルが存在している場合は、属性IDのかわりにそのコントロール・ヒントがラベルとして使用されます。「ラベルの作成」を選択したままにします。
「OK」をクリックして設定を保存します。
JDeveloperによって、編集フォームが、開いているフォームまたはパネル内に新規パネルとして作成されます。
Javaビジュアル・エディタで、新しい編集フォーム・パネルのサイズを変更し、コントロールを表示します。
編集フォームでは、柔軟なコンポーネント・レイアウトのためにJGoodies FormLayoutマネージャが使用されます。
編集フォーム・パネルのソースはファイルPanel<コレクション名>Helper.javaに、パネルのコントロール・バインディング定義はPanel<コレクション名>HelperPageDef.javaに表示されます。
フォーム内でfetchAttributeProperties()メソッドを定義することで、ADF Swingアプリケーションのパフォーマンスを向上させることができます。これにより、フォームはバッチ・モードで動作し、属性値をフェッチするようになります。詳細は、第10.4項「ADF SwingでのADFビジネス・コンポーネント属性のフェッチを制限する方法」を参照してください。
データベース・ウィンドウは、表示されている値を選択したコントロールによって編集可能な、データバインドされたフォームを作成するために使用します。フォームおよび必要なデータ・バインディングが、選択したデータベース表に対して作成されます。
Javaビジュアル・エディタで既存のパネルにフォームを作成する手順は次のとおりです。
ウィザードを使用して空のADF Swingフォームまたはパネルを作成します。
詳細は、第2.2項「ADF Swingパネルおよびフォームの作成手順」を参照してください。
Javaビジュアル・エディタでフォームを開き、「設計」タブをクリックします。
「プロパティ」ウィンドウで、「レイアウト」ドロップダウン・リストからBorderLayoutを選択します。
詳細は、第3.7項「空のSwingフォームでデータ・パネルをレイアウトする方法」を参照してください。
「コンポーネント」ウィンドウで、Swingコンテナページを開き、JScrollPaneコンポーネントを選択します。
Javaビジュアル・エディタで空のフォーム内をクリックし、スクロール・ペインをそのデフォルト・サイズでドロップします。
スクロール・ペインのサイズを変更します。
「ウィンドウ」メニューから、「データベース」→「データベース」を選択します。
「データベース」ウィンドウで、目的のデータベース表を、スクロール・ペインの上部にある開いているフォームまたはパネルにドラッグします。
編集可能フォームを作成する場合、ポップアップ・リストから編集フォームの追加を選択します。
詳細は、第2.11項「「データ・コントロール」パネルからのADF Swing編集フォームの作成方法」を参照してください。
かわりに、子の追加を選択することで空のフォームに特定のコンポーネントを追加します。
詳細は、第3.3項「ADF SwingパネルへのUIコンポーネントの挿入方法」を参照してください。
データ・パネルまたはフォームをレイアウトした後、フォーム内でfetchAttributeProperties()メソッドを定義することで、ADF Swingアプリケーションのパフォーマンスを向上させることができます。これにより、フォームはバッチ・モードで動作し、属性値をフェッチするようになります。詳細は、第10.4項「ADF SwingでのADFビジネス・コンポーネント属性のフェッチを制限する方法」を参照してください。
