ADF固有のプロジェクト・ファイルについて

次の図に示すように、JDeveloper設計時ツールを使用してOracle ADFベースのアプリケーションをビルドする場合、JdeveloperによりOracle ADFに固有のプロジェクト・ファイルが生成されます。

Oracle ADFプロジェクト・ファイル

注意: Oracle ADFファイルと構文の詳細は、『Oracle ADF Developer's Guide』の付録AのADF XMLファイルのリファレンスを参照してください。

モデル・プロジェクトのファイル

ビジネス・サービスに対してデータ・コントロールを登録する際に、DataControls.dcxファイルが作成されます。Oracle ADF Business ComponentsやOracle ADF TopLinkデータ・コントロールを登録する場合は、このファイルが生成されないことに注意してください。それらの状況では、データ・コントロールにより、生成されたサービスからメタデータが直接取得されます。

DataControls.dcx ファイルでは、Oracle ADFデータ・コントロールとして登録されたBeanのファクトリ・クラスが指定されます。EJB、Webサービス、およびBeanベースのデータ・コントロールの場合、パラメータを追加または削除するため、あるいはデータ・コントロール設定を変更するために、プロパティ・インスペクタを使用してこのファイルを編集できます。

Bean(たとえば、EJBセッションBean)をOracle ADFデータ・コントロールとして登録する際に、様々な.xmlファイルが作成されます。定義ファイルでは、Beanの使用可能な属性、アクセッサ、およびクライアント・アプリケーションから使用できるコレクションについて指定されます。開発者がこのファイルを変更するのは、アクセッサ・メソッドがコレクションを返す場合のみです。この場合、戻り型(戻り値の型)を指定する必要があります。Oracle ADF Business Componentsの場合、すべてのアクセッサの戻り型は既知であり、このステップを手動で実行する必要はないことに注意してください。

DataControls.dcxファイルの構文について

Beanベース、およびWebサービス・ベースのビジネス・サービスの場合、モデル・プロジェクト・フォルダの/src/packageディレクトリで、DataControls.dcxファイルが作成されます。アプリケーション・ナビゲータでは、このファイルが、「アプリケーション・ソース」フォルダのモデル・パッケージで表示されます。ファイル・ノードをダブルクリックすると、XMLソース・エディタでデータ・コントロールの説明が表示されます。データ・コントロール・パラメータを編集するには、プロパティ・インスペクタを使用し、構造ウィンドウで希望のパラメータを選択します。

ViewControllerプロジェクトのファイル

様々な.jspまたは.javaファイルは、クライアント・アプリケーションの表示形式ドキュメントです。ビジュアル・エディタとデータ・コントロール・パレットを使用して、Oracle ADFアプリケーションにUIを配置します。データ・バインドUIコンポーネントをドキュメントに挿入した時点で、実行時にOracle ADFバインディング・オブジェクトにアクセスするバインディング式がページに存在するようになります。UIコンポーネントのバインディング・オブジェクトで使用可能なプロパティにより実行時の動作を指定する目的で、ソース・コードの中でバインディング式を直接編集することもできます。

HTMLビジュアル・エディタでStrutsページのフロー・ダイアグラムを最初に開いた時点で、DataBindings.cpxファイルが作成されます。.cpxファイルでは、アプリケーション全体に関するOracle ADFバインディング・コンテキストが定義されます。.cpxファイルにより、Oracle ADFバインディング・オブジェクトを実行時に作成するためのメタデータが提供されます。バインディング・コンテキストでは、アプリケーション全体にわたる、バインディングへのアクセスが用意されています。パラメータを追加または削除するため、あるいはバインディング・コンテナの設定を変更するために、プロパティ・インスペクタを使用してこのファイルを編集できます。

データ・コントロール・パレットおよびJavaビジュアル・エディタを使用して新しいWebページまたはADF Swingパネルを設計するたびに、pageNamePageDef.xmlファイルが作成されます。これらのXMLファイルでは、クライアント・アプリケーションにある各表示形式ドキュメントに対してOracle ADFバインディング・コンテナが定義されています。バインディング・コンテナでは、ページ内でのバインディングへのアクセスが用意されています。したがって、各データ・バインドWebページ、または各ADF Swingパネルに対して、1つのXMLファイルが存在することになります。表現形式ドキュメントからバインディング式を削除する場合、このファイルのバインディング定義を編集する必要が生じることがあります。

注意: JDeveloperを使用してpageNamePageDef.xmlファイルの名前を変更することはできませんが、JDeveloperを使用せずに、MyWork/ViewController/src/viewフォルダでこのファイルの名前を変更することはできます。どうしてもpageName PageDef.xmlファイルの名前を変更する場合、<Containee> idFullNameの各属性内にあるDataBindings.cpxのファイル参照も更新する必要があります。

PageDef.xmlファイルの構文について

PageDef.xmlファイルは、ビュー・コントローラ・プロジェクト・フォルダの/src/view/pageDefsディレクトリにあります。アプリケーション・ナビゲータでは、このファイルが、「アプリケーション・ソース」フォルダのビュー・パッケージで表示されます。ファイル・ノードをダブルクリックすると、XMLソース・エディタにバインディング・コンテナの説明が表示されます。バインディング・コンテナ・パラメータを編集するには、プロパティ・インスペクタを使用し、構造ウィンドウで希望のパラメータを選択します。

DataBindings.cpxファイルの構文について

DataBindings.cpxファイルは、ビュー・コントローラ・プロジェクト・フォルダの/srcディレクトリにあります。アプリケーション・ナビゲータでは、「アプリケーション・ソース」フォルダでそのファイルが表示されます。ファイル・ノードをダブルクリックすると、XMLソース・エディタでバインディング・コンテキストの説明が表示されます。バインディング・コンテキスト・パラメータを編集するには、プロパティ・インスペクタを使用し、構造ウィンドウで希望のパラメータを選択します。


Oracle ADFのバインディングについて
Oracle ADFの機能について
データ・コントロール・パレットについて

コレクションを返すアクセッサ用のBean定義の指定
ビジネス・サービスの変更後にADFデータ・コントロールをリフレッシュ