データ・コントロール・パレットについて

クライアント開発者は、データ・コントロール・パレットを使用して、データ・バインドされたHTML要素(JSPページの場合)、データ・バインドされたFaces要素(JSF JSPページの場合)、およびデータ・バインドされたSwing UIコンポーネント(ADF Swingパネルの場合)を作成します。データ・コントロール・パレットには、使用可能なビジネス・オブジェクト、メソッドおよびデータ・コントロール操作が階層形式で表示されます。

データ・コントロール・パレットから項目をドロップすると、適切なビジュアル要素の選択肢が表示され、ページでオブジェクト表示に使用する要素を選択できます。

また、アプリケーション開発者は、データ・コントロール・パレットを使用して、ビジネス・サービスで用意されているメソッドを選択します。ビジネス・サービスは、アプリケーション・ページにドロップできます。また、Strutsアプリケーションの場合はStrutsページ・フローのデータ・ページおよびデータ・アクションにドロップすることもできます。

データ・コントロール・パレットの使用方法の概要

クライアント・ドキュメントの場合、表示されるビジネス・サービスの階層構造は、次の項目によって決まります。

設計時、データ・コントロール・パレットでは最初のステップとして、クライアントのユーザー・インタフェースをレイアウトし、ADFバインディングを準備します。ビジネス・オブジェクトを選択し、サービスにビジュアル要素を選択してページにドロップするタスクにより、次の項目が生成されます。

別の方法として、バインディングを作成し、データ・コントロール・パレットからドラッグ・アンド・ドロップせずに、ソース・コード内で後から参照することもできます。

データ・コントロール・パレットによりクライアント・ドキュメント内に生成されるコードおよびバインディングは、次のことによって決まります。

データ・コントロール・パレットでクライアント・ドキュメントのレイアウトを完了すれば、個々のバインディング定義を表示してカスタマイズする準備が整います。

データ・コントロール・ビジネス・オブジェクトの概要

データ・コントロール・パレットのルート・ノードは、ビジネス・サービスに登録されているデータ・コントロールを表しています。データ・コントロール自体は選択可能な項目ではありませんが、データ・コントロールでサポートされている操作は選択可能です。データ・コントロール固有のすべての操作は、ルート・ノードのOperationsフォルダに表示されます。ADF Business Componentsのデータ・コントロールで提供されるコミットやロールバックの操作など、ADFバインディング・コンテキスト全体に適用される操作を実行する場合は、このタイプの操作を使用できます。

ルート・データ・コントロール・ノードから階層を下に進むと、パレットに次のBeanベースのビジネス・サービスのいずれかが表示されます。

Webサービスの場合は例外で、データ・コントロール・パレットには操作のみが表示されます。

データ・コントロール・パレットでは、属性および操作は次の表に示すアイコンで表されます。複数回示されているアイコンは、アクセッサの様々な戻り型を表しており、次の表に示している別のビジュアル要素でもサポートされています。

アイコン 名前 説明 作成対象

「データ・コントロール」アイコン

データ・コントロール

データ・コントロールを表します。データ・コントロール自体はUIコンポーネントの作成に使用できませんが、その下にリストされる項目はすべて使用できます。ビジネス・サービスの定義内容によっては、それぞれがデータ機能の論理グループを表す複数のデータ・コントロールが存在することがあります。

作成には使用しません。他のオブジェクトのコンテナとして機能します。

「メソッドの作成」アイコン

メソッドの作成

Java newコンストラクタ・コールを使用してデータ・コレクション内にデータ・オブジェクトの新規インスタンスを作成する組込みメソッドを表します。データ・コレクションは、データ・モデル内の行セットを表します。これらのアイコンは、データ・コントロールのフォルダ内で、データ・コレクションのフルネームを表示する「コンストラクタ」フォルダに表示されます。

入力フォーム。

メソッド・アイコン

メソッド

パラメータを受け入れ、なんらかのアクションまたはビジネス・ロジックを実行し、データまたはデータ・コレクションを戻すことのできる、データ・コントロールのカスタム・メソッドを表します。メソッドがデータベースから行セットを戻すマップのgetメソッドの場合は、その下にメソッド戻り値アイコンがインデント付きで表示されます(後述)。メソッドにパラメータが必要な場合は、その下に必須パラメータを含むフォルダが表示されます。

ボタンやリンクなどのUIアクション。

メソッド戻り値アイコン

メソッド戻り値

ビジネス・サービスのカスタム・メソッドから戻されるデータ・コレクションを表します。メソッド戻り値は、その値を戻すメソッドの下にインデント付きで表示されます。メソッド戻り値の下には、属性、関連するディテール・コレクションを戻すアクセッサ・メソッド、コレクション関連のアクションを実行する他のメソッド、およびコレクションに対して実行できる操作がリスト表示されます。

フォーム、表、ツリーおよび行のナビゲーション・コンポーネント。

アクセッサ戻り値アイコン

アクセッサ戻り値

ビジネス・サービスのBean形式のアクセッサ・メソッドから戻されるディテール・データ・コレクションを表します。アクセッサ・メソッドは、コレクション・エントリがJavaBeansである場合に使用されます。アクセッサ戻り値の下には、属性、関連ディテール・コレクションを戻す他のメソッド、コレクションの値を戻すカスタム・メソッド、およびコレクションに対して実行できる操作がリスト表示されます。

 

フォーム、表、ツリーおよび行のナビゲーション・コンポーネント。マスター・ディテール関連コンポーネントの作成にも使用します。

「属性」アイコン

属性

戻されるデータ・コレクションの各エントリの個別データ要素(属性)を表します。属性は、アクセッサ・メソッドまたはカスタム・メソッドから戻されます。「属性」アイコンは、常にそれが属しているコレクションの下にインデント付きで表示されます。

ラベル、テキストおよび選択リストの各コンポーネント。

操作アイコン

操作

下に表示されるコレクションに対するアクションを実行するデータ・コントロール操作を表します。操作にパラメータが必要な場合は、メソッドの下に必須パラメータのリストを示すフォルダが表示されます。データ・コントロール操作は、各データ・コレクション・ノードの下の「操作」フォルダと、ルート・ノードの下に表示されます。特定のデータ・コレクションの下に表示される操作の対象は、そのデータ・コレクションのみですが、ルート・ノードの下に表示される操作の対象は、そのデータ・コントロールが表すすべてのデータ・コレクションです。

データ・コントロール操作の例は、コミット・アクションやロールバック・アクションです。SRDemoサンプル・アプリケーションには、データ・コントロール操作はありません。

ボタンやリンクなどのUIアクション。

「パラメータ」アイコン

パラメータ

下に表示されるメソッドまたは操作で宣言されるパラメータ値を表します。パラメータは、メソッドまたは操作の下のフォルダに表示されます。

ラベル、テキストおよび選択リストの各コンポーネント。

ビジネス・サービスの定義によっては、データ・コントロール・パレットに表示されるメソッドの戻り値に、ビジネス・サービスに定義されているデータ・コントロールの属性が含まれ冗長な場合があります。選択が可能な場合は、メソッドの戻り値ではなく属性ノードおよびアクセッサ・ノードを選択するのが望ましいです。Oracle ADFバインディングは、データ・コントロールの属性およびアクセッサのみで完全にサポートされます。たとえば、イテレータ・バインディングはメソッドの戻り値として使用できません。

個々のビジネス・サービスのコンテキストでデータ・コントロール・パレットに表示されるオブジェクトの詳細は、「Oracle ADFの機能について」を参照してください。


Oracle ADFを使用するためのツールおよび手順の詳細は、次のトピックを参照してください。

J2EEアプリケーション・クライアントとOracle ADFについて
JDeveloperのADFアプリケーションについて
データ・コントロール・パレットおよびコンポーネント・パレットについて

ビジュアル要素および操作の詳細は、次のトピックを参照してください。

Oracle ADFでサポートされているデータ・コレクション操作について
JSPページ内のADFデータ・バインド・コンポーネントについて
Oracle ADF SwingアプリケーションにおけるUIコンポーネントについて

データ・コントロール・パレットを使用して実行可能な作業は、次のトピックを参照してください。

データ・コントロール・パレットを使用したUIコンポーネントの挿入
データ・コントロール・パレットを使用したビジネス・サービス・アクションの挿入
データ・コントロール・パレットを使用したビジネス・サービス・メソッドの結果の挿入
データ・コントロール・パレットを使用した構造化属性の挿入