データ・アクションを使用したビジネス・サービス・メソッドの実行

データ・コントロール・パレットを使用して、データ・バインドされたStrutsページ・フローのデータ・アクションにメソッドを追加できます。このデータ・アクションにより、Oracle ADFデータ・コントロールを使用してビジネス・サービスで定義されたメソッドが実行されます。

注意: データ・コントロール・パレットは、初めて開いたときには何も表示されないことがあります。次の手順に従って、パレットにモデル・プロジェクトのビジネス・サービスを移入してください。

データ・コントロール・パレットにビジネス・サービスを移入するには、次のようにします。

  1. Oracle ADFアプリケーションからアクセスされるビジネス・サービスを定義します。ビジネス・サービスがモデル・プロジェクト内に表示されます。

  2. モデル・プロジェクト内でADFデータ・コントロールを作成してビジネス・サービスを登録します。データ・コントロール・パレットがすでに開いている場合は、ビジネス・サービスの階層がパレットの最上部に表示されます。

ビジネス・サービスの操作をデータ・アクションに追加するには、次のようにします。

  1. Strutsページ・フロー・ダイアグラムで、ページ・フローを表示します。

  2. 「表示」->「データ・コントロール・パレット」を選択して、パレットを開きます。

  3. データ・コントロール・パレットの階層を開きます。

    データ・コントロール・パレットには次の2種類の操作が表示されます。

  4. ルート・レベルまたはデータ・コレクションで、「Operations」フォルダから必要なアクションを選択し、ドロップダウン・リストから「Method」(唯一の選択肢)を選択します。たとえば、パレットの選択で作成のアクションを追加した場合は、次の図のように表示されます(データ・コレクション、属性および操作の名前は実際とは異なる場合があります)。

    Data Control Palette with top level operations

  5. データ・コントロール・パレットから選択した項目をデータ・アクションにドラッグして、メソッドをページ・フローに追加します。設計時、データ・アクションのアクション・マッピングは次のように更新されます。

    <set-property property="methodName" value="MyPageUIModel.ActionName"/>
    <set-property property="resultLocation" value="${requestScope.methodResult}"/>
    <set-property property="numParams" value="1"/>
    <set-property property="paramNames[0]" value="${param.paramName0}"/>

    注意: 各メソッドのパラメータにはparamNames[]プロパティがあります。メソッドにパラメータがない場合は、numParamsの値は0に設定され、paramNamesプロパティ・セットは存在しません。パラメータが必要なカスタム・メソッドを使用する場合は、Struts構成エディタを使用してparamNamesプロパティを追加する必要があります。パラメータを持つカスタム・メソッドの使用例は、「カスタム・メソッドを使用したビュー・オブジェクトでのバインド・パラメータの設定」を参照してください。

ページ・フローのデータ・アクションに、メソッドをさらに追加できます。


データ・バインディング・オブジェクトのプロパティは設計時にカスタマイズできます。

追加したUIコンポーネントは、ビジュアル・エディタを使用して配置できます。

 

 

Copyright © 1997, 2004, Oracle. All rights reserved.