Oracle ADFでサポートされているデータ・コレクション操作について
ビジネス・サービスを作成してアプリケーションに登録する場合、データ・コントロール・パレットには、次のアクションが表示されます。
- 階層のルート・レベルの「Operations」フォルダで、通常、現在のWebページのバインディング・コンテキスト内にあるすべてのデータ・コレクションを操作するアクション(コミットやロールバックなど)。
- 特定のデータ・コレクション(たとえばEmployeesView)に対する操作。 データ・コレクション固有の操作(作成や削除など)は、データ・コントロール・パレットの「Operations」フォルダに、コレクションの子ノードとして表示されます。
ビジネス・サービスで定義される、通常のデータ・コントロール・レベルのグローバル・アクションには、次のものがあります。
- 「Commit」。データ・オブジェクトの値を、バインドされたデータ・コレクションからデータベースに更新するトランザクションをコミットします。
- 「Rollback」。バインドされたデータ・コレクション内のデータ・オブジェクトの値を更新するトランザクションをロールバックします。データはデータベースに送信されません。
ビジネス・サービスで定義される、通常のデータ・コレクション固有の操作には、次のものがあります。
- 「Create」。ユーザーがレスポンス・オブジェクトを含むフォームを送信した後、バインドされたデータ・コレクション内に新規のデータ・オブジェクトを作成します。 Webアプリケーションの場合、「Create」はデータ・コントロール・パレットに表示されるデフォルトの操作です。 注意: Javaクライアント(Jclient)の場合、パレットから「Create」をドラッグすると、ボタンのアクション・バインディングは、Javaクライアントの指定動作である「CreateInsert」(次を参照)に設定されます。
- 「CreateInsert」。バインドされたデータ・コレクション内に新規のデータ・オブジェクトを作成および挿入します。 この操作は、ユーザーが送信を完了するまで待機しません。 注意: この操作は、Oracle ADF Business Componentsでのみ使用可能であり、データ・コントロール・パレットには表示されません。 Webアプリケーションの場合、既存の作成のみの操作を作成および挿入の操作に変更するには、「UIモデル」でボタンのアクション・バインディング・エディタを表示し、「CreateInsert」を選択します。 JClientアプリケーションの場合、作成および挿入がデフォルトの動作ですが、データ・コントロール・パレットには操作が「Create」として表示されます。
- 「Delete」。バインドされたデータ・コレクションから、現在のデータ・オブジェクトを削除します。
- 「Execute」。データ・コレクションで定義された、バインドされたアクションを実行します。 JavaBeanの場合、Execute操作では、データ・コントロールをリフレッシュします。
- 「Find」。データ・コレクションから、データ・オブジェクトを取得します。
- 「First」。データ・コレクション・レンジ内の、先頭のデータ・オブジェクトに移動します。
- 「Last」。データ・コレクション・レンジ内の、最後のデータ・オブジェクトに移動します。
- 「Next」。データ・コレクション・レンジ内の、次のデータ・オブジェクトに移動します。現在の位置がレンジ内の最後のデータ・オブジェクトである場合、アクションは実行されません。
- 「Next Set」。表示可能なレンジを、バインドされたデータ・コレクションで定義された現在の表示レンジの直後のデータ・オブジェクトに移動します。 たとえば、データ・コレクションが行セットの場合、Next Setでは現在の表示レンジの直後の行に移動します。現在の位置がレンジ内の最後のセットである場合、アクションは実行されません。 注意: この操作は、Oracle ADF Business Componentsでのみ使用できます。
- 「Previous」。データ・コレクション・レンジ内の、前のデータ・オブジェクトに移動します。現在の位置がレンジ内の先頭のデータ・オブジェクトである場合、アクションは実行されません。
- 「Previous Set」。表示可能なレンジを、バインドされたデータ・コレクションで定義された現在のレンジの直前にあるデータ・オブジェクトに移動します。 たとえば、データ・コレクションが行セットの場合、Previous Setでは現在の表示レンジの直後の行に移動します。現在の位置がレンジ内の最後のセットである場合、アクションは実行されません。 注意: この操作は、Oracle ADF Business Componentsでのみ使用できます。
- 「setCurrentRowWithKey(String)」。行キーを、入力フィールドで指定された値から変換されたStringとして渡します。行キーは、バインドされたデータ・コレクション内の現在のデータ・オブジェクトを設定する際に使用します。キーを渡す場合、フォームのURLには行キーの値は表示されません。この操作は、データ・コレクションが、マルチパートの属性キーを定義している場合に使用できます。
- 「setCurrentRowWIthKeyValue(String)」。行キーを、入力フィールドで指定されたStringとして渡します。行キーは、バインドされたデータ・コレクション内の現在のデータ・オブジェクトを設定する際に使用します。この操作は、データ・コレクションが、単一のキー属性を使用していて、マルチパートの属性キーは定義していない場合にのみ使用します。キーを値として渡す場合、フォームのURLに行キーの値が表示されます。
関連項目
データ・コントロール・パレットを使用したビジネス・サービス・アクションの挿入
データ・アクションを使用したビジネス・サービス・メソッドの実行
行の現在位置情報をADFバインディング・コンテキストに渡すURLの挿入
Copyright © 1997, 2004, Oracle. All rights reserved.