Oracle ADFによるデータ・バインディング: Part 1
データ・バインディングの仕組み

はじめに

図1: J2EE アプリケーションのためのOracle ADFアーキテクチャ

Oracle ADFでは、EJB Session Bean、WebサービスおよびADFアプリケーション・モジュール（従来のBC4Jアプリケーション・モジュール）といったテクノロジー・ベースのビジネス・サービス、またはより一般にユーザー作成のJavaBeans によるビジネス・サービスを基にしてデータ・コントロールという抽象オブジェクトを作成することが可能です。このデータ・コントロール（ADFデータ・コントロール）と、ビュー層との結合を担うADFバインディングは、ADFフレームワークのベース・クラスの上で、XMLメタデータを使用して構成されます。これらのベース・クラスには、追加コーディングなしでアプリケーション開発ニーズのほとんどを扱うことができるように機能が用意されています。必要に応じて、フレームワーク・ベース・クラスをカスタマイズしたり、まったく新しいデータ・コントロールおよびバインディング実装を追加することが可能です。

ADFデータ・バインディング・コンセプトの概要

Oracle ADFの主なデータ・バインディング概念は次のとおりです。

• データ・コントロール

  データ・コントロールは、ビジネス・サービス実装を抽象化し、バインディング層が一貫した方法ですべてのサービスからデータをアクセスできるようにしています。

• イテレータ・バインディングとコントロール・バインディング

  バインディングは、バックエンド・データとフロントエンドUI表示を分離する軽量オブジェクトです。 イテレータ・バインディングは、データ・コントロールによって提供されたデータ・オブジェクトのコレクションを扱う一貫した方法を提供します。 コントロール・バインディングはUIコンポーネントに対する標準インタフェースを提供して、そのインターフェースを通して、イテレータ・データのやりとりや、モデル・データの設定/イベント処理を行う「アクション」メソッドの呼び出しなどを可能にします。 バインディングは、動的な、多言語対応のユーザー・インタフェースを容易に構築可能にするための主要メタデータも公開しています。

• バインディング・コンテナ

  バインディング・コンテナは、アプリケーションの特定のページ（またはパネル）用に使用する、イテレータ・バインディングおよびコントロール・バインディングの名前付きグループです。 バインディング・コンテナはUI用にモデル・データの適切なサブセットを提供するため、「UI Model」とも呼ばれます。

• バインディング・コンテキスト

  バインディング・コンテキストはユーザー・アプリケーションに対してデータ環境を提供します。 ユーザー・アプリケーションからアクセスできるすべてのデータ・コントロールおよびバインディング・コンテナが含まれます。

現在/将来の標準テクノロジーに対するサポート

ADFバインディングの設計時のサポート機能

JDeveloperは、Oracle ADFと強固に連携して、完全に宣言的な形式での設計サポートを提供します。 このセクションでは特に、これまでに紹介したOracle ADFバインディング・コンセプトを扱う方法に焦点を当てます。

ユーザーが作成したADFビジネス・コンポーネントのアプリケーション・モジュールはどれも、初期状態でデータ・コントロールとしてアクセス可能です。一方、Webサービス、JavaクラスまたはEJB Session Beanをベースとしたデータ・コントロールは、アプリケーション・ナビゲータ内でそれらを選択して、以下のどちらかの方法で明示的に作成する必要があります。

• コンテキスト・メニューから「データ・コントロールの作成 」を選択する、または
• 項目をデータ・コントロール・パレットまでドラッグ&ドロップする

図 4: データ・コントロールのメタデータが入ったDataControls.dcxファイル

この資料で後に扱うサンプル・アプリケーションでは、 test.model.beans.CommissionPlanという名前のJavaBeanと test.model.services.CommissionService という名前のJavaBeanを利用しています。ソース・コードは次のとおりです。

package test.model.services; import java.util.*; import test.model.beans.CommissionPlan; public class CommissionService { private static final ArrayList plans = new ArrayList(4); public CommissionService() {} public Collection getAvailableCommissionPlans() { return plans; } static { plans.add(new CommissionPlan("High",2000)); plans.add(new CommissionPlan("Medium",1000)); plans.add(new CommissionPlan("Low",500)); } }

CommissionService自身の情報からでは、 getAvailableCommissionPlans はCollection型を返すことしかわからないため、この追加の「Beanクラス」メタデータ・プロパティを使用して、実行時にこのコレクションに入るBeanの種類を指定することができます（この例の場合はtest.model.beans.CommissionPlanです）。 このプロパティは、プロパティ・インスペクタを使用して手作業でセットしなければなりませんが、プロパティを介して CommissionPlanを CommissionServiceに結びつけると、JDeveloperはそのJavaBeanについてのメタデータを記録するだけでなく、 CommissionPlan.xmlメタデータ・ファイルも自動作成します。

必要なデータ・コントロールを作成すると、ユーザー・インタフェース・プロジェクト内で使い始めることができます。 新しく導入されたデータ・コントロール・パレットは、現在のワークスペースで使用可能なすべてのデータ・コントロールを示し、一貫した方法でデータと操作（メソッド）を提示します。

図 7: ドラッグ&ドロップのデータ・バインディングが可能なADFデータ・コントロール・パレット

また EmpServiceDataControlという名前のデータ・コントロールが test.model.services.EmpServiceアプリケーション・モジュール用に自動的に利用可能になるのもわかります。 その ビュー・オブジェクト・インスタンスである Employeesプロパティは Empno、 Ename、 Hiredateなどの属性をもつ行セットです。データ・バインディングの設計作業は、データの提供方法に関係なくどの種類のバックエンド・データ・ソースについても同様です。

図 8: データ・コントロール・パレットによるデータ・バインディングUIコントロールのドロップ

もちろん、Swingパネルまたは高機能Webページ（UIX XML ページ）上で作業を行っている場合には、それらに適切な別のUI要素セットが示されます。 また、コレクションの代わりにパレット内で Ename、amountなどの 属性や操作（Operation） を指定した場合も、それに応じた選択項目が表示されます。

バインディング・コンテナ定義およびバインディング定義を作成するには、暗黙的な方法と明示的な方法の2通りがあります。

データ・バインディングUI要素をデータ・コントロール・パレットから ビジュアル・エディタ、 構造ペイン、または コード・エディタへドラッグ&ドロップすると、JDeveloper が暗黙的にバインディング定義および（必要に応じて）それを格納するバインディング・コンテナ定義を作成します。 つまり次のことを行います。

• 現在のページにすでに対応付けられたバインディング・コンテナ定義があるかどうかをチェックします。 あればそれを使用します。 ない場合は、作成します。

  注意:	JDeveloperは プロジェクト・プロパティのデフォルト・パッケージ設定によって指示されているディレクトリ内に <YourPageNameOrPanelName>UIModel.xml という名前のXMLファイルを作成します。

  
  

• 各UIコントロールに対して、ページのバインディング・コンテナ定義に適切なバインディング・オブジェクト定義を追加し、ページ上にドロップするUI要素内でそのバインディング定義を参照します。

図10: 現行のバインディング定義に対するプロパティ・インスペクタ

上のプロパティ・インスペクタ内の EmployeesIter イテレータ・バインディングの モデル参照プロパティの値を見ると、 EmpServiceDataControlデータ・コントロール内の Employeesという名前のデータ・コレクションを参照していることがわかります。

行の表示に使用される レンジ・バインディングである Employeesという名前のコントロール・バインディングをクリックすると、プロパティ・インスペクタ内でイテレータ名プロパティとして EmployeesIterが設定されていることがわかります。 コントロール・バインディングはこれらのプロパティ値を介してイテレータ・バインディングに関連付けられ、さらにイテレータ・バインディングはそれを提供するデータ・コントロール内のデータに結びつけられます。

バインディングのデフォルト名が気に入らない場合は、プロパティ・インスペクタを使用して ID プロパティの値を変更できます。

図 13: 主なランタイム・バインディング・オブジェクトのUML図

バインディングを手動で作成するとき、バインディングの定義に必要なプロパティのいくつかを取得するためバインディング・エディタが表示されます。 手動作成されたバインディングのデフォルト名はプロパティ・インスペクタを使用して変更できます。 バインディングを削除する必要がある場合は、バインディングを選択して、右クリック・メニューから「削除」を選択します。

図 14: バインディング・コンテキストを定義しているDataBindings.cpxファイル

DataBindings.cpxファイルは、このアプリケーションで使用中のデータ・コントロールの目次の役割を果たします。 実行時、データ・コントロールとバインディング・コンテナ用のメタデータ定義が遅延ロードされます。

オンライン・ヘルプ内のADF情報

簡単な作業例による説明に入る前に、JDeveloperオンライン・ヘルプについて紹介しておきます。ここには、ADFデータ・コントロールとADFバインディングについての詳細だけでなく、各種クライアントおよびバックエンド・ビジネス・サービス実装の組み合わせでとともにそれらを使用する方法についてのチュートリアルも提供されていることに注意してください。

図 15: ヘルプ・ナビゲータ・ウィンドウ

ヘルプ・トピックを選択した後、エディタ領域に新しいタブが表示され、ヘルプ資料を読むことができます。
特に以下のトピックは、最初に参考にする項目として有効ですので紹介しておきます。

• 「Oracle ADFデータ・コントロールについて 」トピック
  

  J2EEアプリケーションの構築
  → Oracle Application Development Frameworkの使用
  → J2EEプラットフォームとOracle ADFについて
  の下にあります。

• 「Oracle ADFのバインディングについて 」トピック
  

  J2EEアプリケーションの構築
  → Oracle Application Development Frameworkの使用
  → Oracle ADFデータ・バインド・コンポーネントを使用したユーザー・インターフェースの設計
  の下にあります。ADFバインディングの詳細についての説明があります。

• 「ADFバインディングのプロパティについて 」トピック
  

  J2EEアプリケーションの構築
  → Oracle Application Development Frameworkの使用
  → Oracle ADFアプリケーションのカスタマイズ
  の下にあります。各ADFバインディングの固有な情報およびそのバインディングが実行時にクライアントに公開するプロパティについての説明があります。

実際のアプリケーション例によるケーススタディ

ADFBindingIntroサンプル・アプリケーションは、 showEmployees.jspという名前のJSPページで構成されています。そのページは、ADFアプリケーション・モジュールに基づいたデータ・コントロールと単純なJavaBeanに基づいたデータ・コントロール、つまり2つの異なるデータ・コントロールのデータを表示します。

図 16: showEmployees.jspページ

新しいStrutsページ・フロー図を使用して、6つの異なるStrutsアクションを構築しました。データ・レンダリングのため6つともすべて最終的には同じ showEmployees.jspページに転送されます。 StrutsアプリケーションからADFバインディング・コンテナを使用するときの各種オプションを示すため、6つの異なるアクションを用意しました。これらは大きく2つのカテゴリに分類されます。

• ページ・ライフサイクルをStrutsアクションにハード・コーディングするアプローチ

• ADFのDataAction（基本的なページ・ライフサイクル処理を実装済）を拡張利用したアプローチ

両方のアプローチに対して、更に3つのタイプの実装例を提示しています。これによって、ADF/Struts プロジェクトで何が可能なのか、今後どのアプローチがよりよいのか、の理解の助けになるかと思います。

次にADF/Strutsランタイム統合機能がどの部分で利用されているかに注目しながら、サンプル・アクションおよびその動作の仕組みを調べていきます。

StrutsアクションがADFバインディング・コンテキストにアクセスできるようにするためには、 web.xml ファイル内で ADFBindingFilterを適切に設定する必要があります。これはJDeveloper設計ツールによって 自動的に 行われます。 ViewController.jpr プロジェクト内の web.xmlファイルを確認すると、以下の必須エントリを見ることができます。なお、この ADFBindingFilter に対して設定されている encoding 初期パラメータによって、リクエストで送られるデータの文字コードを指定することができます。

: <!-- ADF Binding Filter Class Setup --> <filter> <filter-name>ADFBindingFilter</filter-name> <filter-class>oracle.adf.model.servlet.ADFBindingFilter</filter-class> <init-param> <param-name>encoding</param-name> <param-value>Shift_JIS</param-value> </init-param> </filter> <!-- | ADF Binding Filter Setup to engage the filter when | the Struts "action" servlet is used. +--> <filter-mapping> <filter-name>ADFBindingFilter</filter-name> <servlet-name>action</servlet-name> </filter-mapping> : <!-- Servlet setup for the Struts action servlet --> <servlet> <servlet-name>action</servlet-name> <servlet-class>org.apache.struts.action.ActionServlet</servlet-class> : </servlet> <!-- Servlet setup to map *.do URL's to the Struts action servlet --> <servlet-mapping> <servlet-name>action</servlet-name> <url-pattern>*.do</url-pattern> </servlet-mapping> :

ADFBindingFilterは、このアプリケーションのバインディング・コンテキスト定義として使用するcpxファイルを決めるために、 CpxFileName というサーブレット・コンテキスト・パラメータの値を調べます。 このサンプル・アプリケーションの場合は、 web.xmlファイル内に以下の行が見つかります。

<context-param> <param-name>CpxFileName</param-name> <param-value>DataBindings</param-value> </context-param>

これは、 DataBindings.cpxファイルを読み込んでバインディング・コンテキストの内容を検出することを意味します。

アクションによって使用されるADFバインディング・コンテナの名前を宣言的に設定できるようにするために、アクションに対して（classNameによって） DataActionMapping実装クラスを使用するように指定し、子タグとして <set-property>タグを追加して modelReferenceプロパティに値を割り当てます。 modelReferenceの値は、 DataBindings.cpxファイル内にリストされているバインディング・コンテナの1つの短縮名でなければなりません。 必要なのは短縮名だけです。 バインディング・コンテナが最初に使用されるときに、そのファイルの完全パッケージ修飾名がバインディング・コンテキストから検索されます。

以下は struts-config.xml ファイル内の"/showEmpsActionCentric" アクションの設定部分で、sample.controller.ShowEmpsActionCentricAction アクション・クラスによって実装されています。

<action path="/showEmpsActionCentric" type="sample.controller.ShowEmpsActionCentricAction" className="oracle.adf.controller.struts.actions.DataActionMapping" name="DataForm"> <set-property property="modelReference" value="showEmployeesUIModel"/> <forward path="/showEmployees.jsp" name="success"/> </action>

アクション用のバインディング・コンテナにアクセスする場合は、次のようなコードを使用できます。

/** * Setup the binding container for use. Name of the binding container * to use is gotten from the modelReference property on the Struts * action mapping (through the extended DataActionMapping in the * oracle.adf.controller.struts.actions package). */ private void initializeBindingContainer(ActionMapping mapping, HttpServletRequest request) { if (mapping instanceof DataActionMapping) { DataActionMapping daMapping = (DataActionMapping)mapping; String bindingContainerName = daMapping.getModelReference(); DCBindingContainer bc = getBindingContainer(request); if (bc == null) { BindingContext ctx = HttpBindingContext.getContext(request); bc = DCUtil.findBindingContainer(ctx, bindingContainerName); if (bc != null) { /* * Put a reference to the binding container under the * request-scoped attribute named "bindings" so JSP pages * can easily refer to bindings in the binding container * using EL expressions like ${bindings.Empno} */ request.setAttribute(BINDINGS, bc); } } } }

コードは、アクションから modelReferenceプロパティを参照し、 getBindingContainer()ヘルパー・メソッドを使用してバインディング・コンテナがこのリクエスト中にすでにセットアップ済みかどうかを調べます。 セットアップ済みでなければ、ビュー層のページが${bindings.BindingName}のようなEL（式言語）を使用してバインディング・コンテナにアクセスできるように、 DCUtil.findBindingContainer()を呼び出して" bindings"属性をリクエスト・スコープ内にセットします。

バインディング・コンテナがあれば、その中に含まれているバインディングをどれでも見つけることができます。 バインディング・コンテナに含まれるデータ・コントロールはイテレータ・バインディング経由でアクセス可能です。 また、より明示的に、名前でバインディング・コンテキストから見つけ出すこともできます。次のサンプル・コードは、データ・コントロールを名前で見つけ出し、それがある実装クラスのタイプであるかどうか（この例の場合は、ADFアプリケーション・モジュールに基づくデータ・コントロールであるかどうか）を判別し、そのインターフェースを返す方法を示しています。

protected ApplicationModule getApplicationModule(String dataControlName, HttpServletRequest request) { DCDataControl dc = HttpBindingContext.getContext(request).findDataControl(dataControlName); /* * Test to see if our data control is an instance of the ADF Business Components * Data Control before trying to cast the data provider to a specific * service interface */ if (dc instanceof DCJboDataControl) { return (ApplicationModule) dc.getDataProvider(); } return null; }

HTTPリクエストの受け渡しライフサイクルの基本手順は次のとおりです。

1. バインディング・コンテナの初期化
2. カスタム・コントローラの処理と ActionForwardの決定
3. バインディング・コンテナの解放

手動コーディングのアクションのすべてはこの方法に準ずる必要があり、そのサンプルとして、デフォルトのStruts Action#execute()メソッドをオーバーライドしてこの基本ライフサイクルを定義する BasicADFActionクラスを作成してあります。

public final ActionForward execute(ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) throws Exception { return handleLifecycle(mapping, form, request, response); }

ここでは、execute() を final で宣言して、このサブクラスが必ずライフサイクル処理をとおるようにしています。この中でよばれる handleLifecycle メソッドは次のようなコードです。

protected ActionForward handleLifecycle(ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) throws Exception { initializeBindingContainer(mapping,request); ActionForward fwd = performActionLogic(mapping,form,request,response); refreshBindingContainer(request); return fwd; }

3つのカスタム・アクション

• ShowEmpsActionCentricAction
• ShowEmpsTypesafeAction
• ShowEmpsActionBindingAction

は、必要なカスタム・コントローラ処理を提供するために BasicADFActionを拡張して、handleLifecycle 内から呼ばれる performActionLogic() メソッドをオーバーライドしています。

このデモで実装する基本機能は、従業員（Employees）データ一覧を順序付けて表示することです。 sortという名前のHTTPパラメータの値がない場合または文字 "a"に等しい場合、昇順ソートを実行します。 sortパラメータの値が文字 "d"に等しい場合は、降順ソートを実行します。

ShowEmpsActionCentricActionは、JDeveloperリリース9.0.3/9.0.4を使用している開発者がよく知っている方法でこの機能を実現する方法を示しています。

public class ShowEmpsActionCentricAction extends BasicADFAction { protected ActionForward performActionLogic(ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) throws Exception { ApplicationModule am = getApplicationModule("EmpServiceDataControl", request); ViewObject vo = am.findViewObject("Employees"); String sortDirection = request.getParameter("sort"); if (sortDirection == null || sortDirection.equals("a")) { vo.setOrderByClause("sal asc"); } else { vo.setOrderByClause("sal desc"); } vo.executeQuery(); return mapping.findForward("success"); } }

このアクション・コードは（BasicADFActionから継承された適切なヘルバー・メソッドを使用して） アプリケーション・モジュールを見つけ出し、"Employees"というインスタンス名を持つビュー・オブジェクトのORDER BY句の設定に進みます。

一般に、アクションを実行するサーバーとは別のリモート・サーバーでバックエンド・ビジネス・サービスが実行される場合、それに対する多数のメソッド呼び出しをするような、ネットワーク経由での「おしゃべり」をできるだけ避けるように注意する必要があります。このため、ADFアプリケーション・モジュールにはカスタム・サービス・メソッドのクライアントへの公開をサポートしています。カスタム・メソッドの中ですべてのモデル情報の変更操作を行うことにより、バックエンド・ビジネス・サービスがあるリモート・サーバーへの呼び出しは一度のラウンドトリップで実施できます。 ShowEmpsTypesafeActionは、アプリケーション・モジュールのカスタム・メソッドprepareModelForShowEmployeesPageを起動する ShowEmpsTypesafeActionの改良形です。

public class ShowEmpsTypesafeAction extends BasicADFAction { protected ActionForward performActionLogic(ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) throws Exception { /* * "EmpService" is the custom business service interface created by * the ADF Business Components wizard when you mark a custom method * like "prepareModelForShowEmployeesPage" as exported to the client. */ EmpService svc = (EmpService)getApplicationModule("EmpServiceDataControl", request); svc.prepareModelForShowEmployeesPage(request.getParameter("sort")); return mapping.findForward("success"); } }

ADFのバインディング機能の一つにアクション・バインディングというものがあります。これは、クライアント層と、データ・コントロールのサービス・メソッドの間を緩衝材のような役割をはたします。データ・コントロールのサービス・メソッドを直接クライアントから呼ぶのではなく、それらを切り離して、代わりにアクション・バインディングを使用することが可能です。アクション・バインディングは、実行時にメタ・データから実際のメソッドの情報を取得し、それを起動します（必要ならばパラメータを受け渡します）。そして、その結果を取得します。

ShowEmpsActionBindingAction のコードでは、以下のように、サービスのメソッド起動のためにアクション・バインディングを使用しています。

public class ShowEmpsActionBindingAction extends BasicADFAction { protected ActionForward performActionLogic(ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) throws Exception { invokeActionBinding("prepareModelForShowEmployeesPage", request.getParameter("sort"), request); return mapping.findForward("success"); } }

この中で呼び出されている invokeActionBinding メソッドは、ベースである BasicADFAction に用意されています。 invokeActionBinding を見ると、メソッドに対して受け渡すべきパラメータを ArrayList にして提供していることがわかります。この例では、起動されるメソッドの戻り値はない（void）ので、何もせずにその後の処理に進んでいますが、戻り値が期待される場合には、アクション・バインディング・オブジェクトに対する getResult() を使って取得可能です。

"/showEmployeesTypesafe"という名前のサンプル内の4つ目のStrutsアクションは、手動コーディングによるアクション・アプローチの代わりに汎用ADF DataActionの機能を使用して実装されます。 DataActionは、上の BasicADFAction内に用意した基本的なロジックに加えて、さらに完全なリクエスト処理ライフサイクルを実装しています。 構造的にBasicADFActionに似たアプローチを使用して、DataActionベース・クラス（ oracle.adf.controller.struts.action パッケージ）はベースStrutsアクションの execute() メソッドをオーバーライドし、いくつかのライフサイクル・メソッドを呼び出して、すべてのリクエストで必要な共通手順を施行します。

DataActionによるライフサイクル処理は次のとおりです。

• Webから送信されたフォームの値で、バインディング・コンテナの適切なコントロール値を更新する
• モデル層の妥当性チェックを実行して、例外がスローされた場合、それらを一括化する
• すべての例外をStruts ActionErrorsとして報告する
• 適切なボタンが押されたときにバインディング・コンテナ内の適切なコントロール・アクション・バインディングを呼び出す
• 宣言的に定義されたメタデータに基づいてデータ・コントロール上のカスタム・メソッドを呼び出す
• ActionForwardを返して、次に進むべき制御の流れ（レンダリングのためにページへ進むか別のアクションに進むか）を決定する

このサンプルでは、CustomizedDataAction という、 DataAction を拡張したクラスを用意して、先ほど紹介した BasicDataAction と同様、invokeActionBinding というメソッドを用意しています。 ShowEmployeesActionBindingAction はこの CustomizedDataAction の拡張クラスで、prepareModel という（DataActionの）メソッドをオーバーライドしています。

public class ShowEmployeesActionBindingAction extends CustomizedDataAction { protected void prepareModel(DataActionContext ctx) throws Exception { invokeActionBinding("prepareModelForShowEmployeesPage", ctx.getHttpServletRequest().getParameter("sort"), ctx); super.prepareModel(ctx); } }

ADF DataAction では、ライフサイクル期間内の多くの情報の受け渡しを効率化するために、DataActionContext というオブジェクトを利用するよう設計されています。このオブジェクトは、現行のHTTPリクエストの処理中のみ存在し、データ・アクションに渡すべきものにアクセス可能なsetXXX/getXXX メソッドを含んでいます。上記のコード内では、getHttpServletRequest() でHTTPリクエスト・オブジェクトにアクセスし、sort パタメータの値を取得しています。 他にも、DataActionContext には、getBindingContext()、getBindingContainer() といった有用なメソッドや、次のどこを進むべきかを決定できるように Struts の ActionForward を設定したり、Struts のエラー出力などに関連する情報を設定するためのメソッドも用意されています。

手動コーディングで実装した例と、DataAction を利用する例との一番の違いは、DataAction を利用すれば、コードを書く手間が大きく軽減されるという点でしょう。この機能豊富なベース実装が提供されているため、開発者は、地道なリクエスト処理のためのコーディングを省略して、アプリケーションで必要なコードだけのために Struts の標準的な Action の拡張/オーバーライドをすればよいことになります。

Strutsアクションは、一般に以下のケースで使用されます。

• ページ表示のための初期データの設定
• ページからのフォーム送信のイベント処理

Webページのデザイン・パターンのひとつで、「ポストバック」と呼ばれるものがあります。これは、ひとつのページに対するデータの初期化ロジックとページ・イベント処理を同じアクションで処理する手法です。 Oracle ADFの DataForwardAction （DataActionの拡張クラス）は、このパターンに従い、それによって、ページフロー・ダイアグラムを簡略化します。

図 19: DataPageに対するアクションとページ情報のツールチップ表示

 
  <action path="/showEmployeesTypesafe"
          className="oracle.adf.controller.struts.actions.DataActionMapping"
          type="sample.controller.ShowEmployeesTypesafeAction"
          name="DataForm"
          parameter="/showEmployees.jsp">
    <set-property property="modelReference" value="showEmployeesUIModel"/>
  </action>

以下のコードでわかるように、ShowEmployeesTypesafeAction クラスはDataForwardActionを使用して定義されており、データ・コントロールのサービス・メソッドを呼ぶという、すでに説明済みの手法（ ShowEmpsTypesafeAction と同じアプローチ）を使用しています。

public class ShowEmployeesTypesafeAction extends DataForwardAction { protected void prepareModel(DataActionContext ctx) throws Exception { /* * "EmpService" is the custom business service interface created by * the ADF Business Components wizard when you mark a custom method * like "prepareModelForShowEmployeesPage" as exported to the client. */ EmpService svc = (EmpService)ctx.getBindingContext() .findDataControl("EmpServiceDataControl") .getDataProvider(); svc.prepareModelForShowEmployeesPage(ctx.getHttpServletRequest().getParameter("sort")); super.prepareModel(ctx); }

最後の例である /showEmployeesDeclarative アクションについて説明します。この DataPage は、これまでにみたアクションと同じ機能を実現しますが、そのためにカスタム・コードを一切必要としません。DataAction と DataForwardAction （DataPage を表すアクション）は、データ・コントロールのメソッド機能を宣言的に設定可能なように設計されています。

これまでに /showEmpsActionBinding と /showEmployeesActionBinding の例で見てきたように、ADF アクション・バインディング によって、 データ・コントロールのメソッドへの相互作用はカプセル化されます。メソッド起動の仕組みを完全に宣言的に設定可能なように、DataAction は次のような追加機能を実装しています。

• 選択された アクション・バインディングを、組み込みのページ・ライフサイクル処理の一部として起動する
• EL表現によって指定された値からメソッドに引き渡すパラメータ値を初期化する

では、ここで、/showEmployeesDeclarative データ・アクションによって施行されるメソッド起動の設定について説明しましょう。 EmpServiceDataControl データ・コントロールの prepareModelForShowEmployeesPage メソッドをデータ・コントロール・パレットからドラッグして、ページ・フロー図の"/showEmployeesDaclarative" データ・アクションにドロップすると、JDeveloper設計ツールによって struts-config.xml ファイル内に必要なプロパティが自動的にセットアップされるため、DataActionが実行時に prepareModelForShowEmployeesPageメソッドを呼び出すことができるようになります。 上で見た modelReferenceプロパティのほか、下の <action>エントリからわかるように、 methodName、 resultLocation、 numParamsおよび paramNames[0]などの追加プロパティがあります。 numParamsの値は、 prepareModelForShowEmployeesPageメソッドが1つの引数を受け付け、そのメソッドがフレームワークによって呼び出されたときに paramNames[0]プロパティがそのプロパティの値を評価するEL表現を提供することを示しています。 式 ${param.sort}は、 sortという名前のHTTPリクエスト・パラメータを参照するための標準のEL構文です。

<action path="/showEmployeesDaclarative" className="oracle.adf.controller.struts.actions.DataActionMapping" name="DataForm" parameter="/showEmployees.jsp" type="oracle.adf.controller.struts.actions.DataForwardAction"> <set-property property="modelReference" value="showEmployeesUIModel"/> <set-property property="methodName" value="showEmployeesUIModel.prepareModelForShowEmployeesPage"/> <set-property property="resultLocation" value="${requestScope.methodResult}"/> <set-property property="numParams" value="1"/> <set-property property="paramNames[0]" value="${param.sort}"/> </action>

/showEmployeesDaclarative用のコントローラ・コードを何も作成しなくても、モデルに対して準備作業を行うためにデータ・コントロール・メソッドが呼び出され、レンダリングのために制御をshowEmployees.jspページに転送すべくデフォルトの「success」への転送が戻される結果になります。

図 21: 実行時のshowEmployees.jspページ出力

表のレンダリングは、JSTL <c:forEach>タグの使用によって達成されます。 たとえば従業員表の行は、次のタグでレンダリングされます。

<!-- | REMEMBER that "e" is a local variable assigned to ${bindings.Employees} | range control binding at the top of this JSP page +--> <c:forEach var="x" items="${e.rangeSet}" varStatus="idx"> <tr class="r<c:out value='${idx.index % 2}'>" > <td><c:out value="${x.Empno}"/></td> <td><c:out value="${x.Ename}"/></td> <td><c:out value="${x.Sal}"/></td> </tr> </c:forEach>

Employeesレンジ・バインディングの rangeSetプロパティは、ビュー・オブジェクトの現在の範囲内の行をコレクションとして公開します。 <c:forEach>タグの var="x"属性が " x"という名前のループ変数を割り当てた後、そのループ内のタグがELのドット表記を使用して各行内の属性値を参照します。また、 <c:forEach>タグ内の varStatus="idx" という属性によって、このループ内の ステータスを表す変数 " idx" が割り当てられています。JSTL仕様により、この変数の index 値によって、現在行がイテレータ内の何行目であるかを知ることができます。次のコードに注目してください:

<tr class="r<c:out value='${idx.index % 2}'/>">

ここでは、<tr> タグ内の class属性に対して、JSTL <c:out> タグが埋め込みの形で使用されています。idx.index 値を 2 でわったあまりが 1 であるか 0 であるか（その行が奇数番目の行か偶数番目の行か）によって、その結果適用される CSSクラスが"r1" か "r0" かに変化するようになっています。これにより、このサンプルのデータ行は、行ごとに異なるカラーで示されます。この CSSクラスは css/blaf.css スタイルシート内に定義されています。

ADFデータ・バインディングに関するQ & A

新しいADFデータ・バインディング機能に関する質問とその回答です。

 
<adf:uimodelreference model="BindingContainerName"/>

 
<adf:uimodelreference model="BindingContainerName"
                      lifecycle="your.package.yourLifeCycleBean"/>

最後に

この資料が新しいADFバインディング・アーキテクチャの機能および設計時の解明に少しでも役立つことを期待しています。

• 本書はOracle Corporation発行の「Oracle ADF Data Binding Primer」の翻訳版です。
• この文書はあくまでも参考資料であり、掲載されている情報は予告なしに変更されることがあります。 万一、誤植などにお気づきの場合は、オラクル社までお知らせください。オラクル社は本書の内容に関していかなる保証もしません。また、本書の内容に関連したいかなる損害についても責任を負いかねます。