Oracle® Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド 11gリリース1(11.1.1.9.0) B52028-07 |
|
![]() 前 |
![]() 次 |
この章では、アプリケーション内でナビゲーション、カプセル化、再利用、マネージドBeanのライフサイクルおよびトランザクションを使用できるようにするADFタスク・フローの作成方法について説明します。これにはタスク・フロー・ダイアグラムの作成、このダイアグラムへのアクティビティと制御フローの追加、および完成したタスク・フローの実行の基本的な手順が含まれています。
この章には次の項が含まれます:
ADFタスク・フローは、アプリケーションでコントロール・フローを定義するためのモジュール式アプローチを提供します。アプリケーションは単一の大規模なJSFページ・フローとして表すのではなく、再利用可能な一連のタスク・フローに分割できます。各タスク・フローには、アプリケーションのナビゲーション・グラフが含まれます。タスク・フロー内のノードは、アクティビティです。アクティビティ・ノードでは、ページの表示、アプリケーション・ロジックの実行または別のタスク・フローのコールなど、シンプルな論理的操作が表示されます。アクティビティ間のトランザクションは、制御フロー・ケースと呼ばれます。
図14-1に、Create
およびConfirm
と呼ばれる2つのビュー・アクティビティを示します。これらのビュー・アクティビティは、JSFページ・フロー内部のページ・ノードに類似しています。
タスク・フローはマネージドBeanを起動します。タスク・フローで使用するマネージドBeanの定義、サポートしているメモリー・スコープ、その他の関連する情報の詳細は、14.2.4項「タスク・フロー用のメモリー・スコープに関する必知事項」および20.4項「Fusion Web ApplicationでのマネージドBeanの使用」を参照してください。
表14-1に示すように、ADFタスク・フローは標準JSFページ・フローに比べ大きな利点があります。
表14-1 ADFタスク・フローの利点
JSFページ・フロー | ADFタスク・フロー |
---|---|
アプリケーション全体を単一のページ・ナビゲーション・ファイルに配置する必要があります( |
アプリケーションは、相互にコールする一連のモジュール型のフローに分割できます。 |
JSFページ・フロー内のすべてのノードは、JSFページである必要があります。他のタイプのオブジェクトは、JSFページ・フロー内には存在しません。 |
ビュー、メソッド・コールおよび他のタスク・フローへのコールなどのタスク・フロー・ダイアグラム・ノードに追加できます。 |
ナビゲーションはページ間のみです。 |
ナビゲーションは複数のページや、ルーターを含む他のアクティビティにも及びます。詳細は、15.4項「ルーター・アクティビティの使用」を参照してください。 |
アプリケーション・フラグメントを再利用できません。 |
ADFタスク・フローは、同一、または完全に別のアプリケーション内で再利用可能です。 アプリケーションをタスク・フローに分割した後で、一般機能を備えたタスク・フローを再利用できます。 詳細は、第33章「アプリケーション・コンポーネントの再利用」を参照してください。 |
セッション・スコープを除き、複数のリクエスト間では共有メモリー・スコープがありません。 |
タスク・フロー内のアクティビティ間でのデータ渡しを可能にする共有メモリー・スコープ(ページ・フロー・スコープなど)があります。ページ・フロー・スコープは、ADFバインド・タスク・フローの各インスタンスに対して、一意の記憶域を定義します。 |
ADFタスク・フローには次の2つのタイプがあります。
バインドなしタスク・フロー: ユーザーがタスクを完了できるように対話する一連のアクティビティ、制御フロー・ルールおよびマネージドBeanです。ADF無制限タスク・フローは、バインド・タスク・フローに組み込まれていないアプリケーション内のすべてのアクティビティと制御フローで構成されます。
バインド・タスク・フロー: タスク・フローの特殊な形式であり、無制限タスク・フローとは異なり、単一エントリ・ポイントと0以上の終了ポイントがあります。プライベート制御フロー・ルール、アクティビティおよびマネージドBeanの独自のセットが含まれています。ADFバインド・タスク・フローでは、再利用、パラメータ、トランザクション管理および再開が可能です。
ADFの無制限またはバインド・タスク・フローに追加可能なアクティビティ・タイプの説明は、第15章「タスク・フロー・アクティビティの使用」を参照してください。
バインド・タスク・フローは、タスク・フロー定義とも呼ばれます。デフォルトでは、JDeveloperはバインド・タスク・フローのソース・ファイルに対して次のファイル名を使用します。
task-flow-definition
N
.xml
ここでNは新しいバインド・タスク・フローを作成するたびに増分する番号です。
このファイルにはバインド・タスク・フローのメタデータが含まれています。複数のタスク・フロー定義(バインド・タスク・フロー)を、同じタスク・フロー定義ファイル内に含むことができます。
一般的なアプリケーションは、1つの無制限タスク・フローと1つ以上のバインド・タスク・フローを組み合せたものです。たとえば、デフォルトではFusion Web Applicationテンプレートを使用してFusion Webアプリケーションを作成すると、JDeveloperが無制限タスク・フロー(ソース・ファイル名はadfc-config.xml
)を作成します。実行時、Fusion Webアプリケーションはこの無制限タスク・フローに追加したアクティビティからバインド・タスク・フローをコールできます。
図14-2に示すように、多くの場合、アプリケーションで実行する最初のアクティビティは、ADF無制限タスク・フロー内のビュー・アクティビティです。ビュー・アクティビティは、アプリケーションの一部として表示するJSFページを表します。図14-2に示すアクティビティは、Home
ビュー・アクティビティで始まり、バインド・タスク・フローをコールします。calltoLogin_taskFlow
アクティビティは、ユーザーのアプリケーションへのログインを可能にするバインド・タスク・フローをコールします。
また、すべてのアプリケーション・アクティビティがADF無制限フロー内にあるアプリケーションも設計できます。これはStrutsやJSFアプリケーションを模倣したものですが、ADFバインド・タスク・フロー機能の利点が活用されていません。タスク・フロー機能を十分に活用するには、ADFバインド・タスク・フローを使用します。
Fusion Webアプリケーションには常にADFバインドなしタスク・フローが組み込まれており、アプリケーションへのエントリ・ポイントが含まれています。図14-3は、Fusion Order Demoアプリケーションからのバインドなしタスク・フローのダイアグラムを示しています。このタスク・フローにはいくつかのビュー・アクティビティが含まれており、いずれもアプリケーションへのエントリ・ポイントになっています。
次のような状況では通常、バインド・タスク・フローではなく無制限タスク・フローを使用します。
ビュー・アクティビティのブックマークなど、バインド・タスク・フローでは提供されないADFコントローラ機能を利用する場合。詳細は、15.2.3項「ビュー・アクティビティのブックマーク」を参照してください。
タスク・フローが別のタスク・フローによってコールされない場合。
アプリケーションに複数のエントリ・ポイントがある場合。図14-3では、バインドなしタスク・フロー上にビュー・アクティビティ・アイコンで表されるどのページからでも、タスク・フローを開始できます。
ページはビュー・アクティビティに関連付けられます。ビュー・アクティビティのアイコンには、次のようなページ・イメージが表示されます。
タスク・フローで複数のアクティビティにブックマークを付ける場合。詳細は、15.2.3項「ビュー・アクティビティのブックマーク」を参照してください。
無制限タスク・フローではパラメータを宣言的に指定できません。さらにここでは、デフォルト・アクティビティ、つまりバインドなしタスク・フローで最初に実行するよう設計されたアクティビティも含まれません。これは、無制限タスク・フローには単一エントリ・ポイントがないためです。これらのいずれかを実行するには、ADFバインド・タスク・フローが必要です。
完全に宣言的なADFコントローラ・トランザクションおよび再開サポートを利用するには、無制限タスク・フローではなくバインド・タスク・フローを使用します。
ADFバインド・タスク・フローを使用して、アプリケーションの再利用可能な部分をカプセル化します。バインド・タスク・フローは、次のようなJavaメソッドに類似しています。
単一エントリ・ポイントがある。
入力パラメータを受け入れることができる。
戻り値を生成できる。
アクティビティおよび制御フロー・ルールの独自のコレクションがある。
独自のメモリー・スコープおよびマネージドBeanの存続期間(ページ・フロー・スコープ・インスタンス)がある。
図14-3
のcheckout-task-flowアクティビティは、ADFバインド・タスク・フローのコールです。無制限タスク・フローはADFバインド・タスク・フローをコールできますが、別のタスク・フローからはコールできません。バインド・タスク・フローからは別のバインド・タスク・フローをコールでき、さらにそのバインド・タスク・フローからも次々にコールできます。コールに深さ制限はありません。
チェックアウト・プロセスは、図14-4のように別個のADFバインド・タスク・フローとして作成されます。
コール先のバインド・タスク・フローとしてcheckout-task-flow
アクティビティを作成する理由は次のとおりです。
バインド・タスク・フローでは、常にバインド・タスク・フローの開始直後に実行する必要のある単一エントリ・ポイントとなる、デフォルト・アクティビティを指定します。
チェックアウト・タスク・フローのreconcileShoppingCart
というアクティビティは、無名ユーザー(アプリケーションにまだログインしていないユーザー)が購入するものとして選択した可能性のあるアイテムのリストを返すメソッドを呼び出します。認証前に選択されたアイテムは、ユーザーがログインするとショッピング・カートに追加されます。このメソッドはデフォルト・アクティビティであるため、常にショッピング・カート注文ページが表示される前に起動されます。
checkout-task-flow
は再利用が可能です。たとえば、アイテムのチェックアウト・プロセスを必要とする他のアプリケーションに組み込むことができます。バインド・タスク・フローは、同じアプリケーション内でも再利用できます。
checkout-task-flow
内で使用することにしたマネージドBeanは、ページ・フロー・スコープで指定できるため、残りのアプリケーションからは分離されます。
表14-2に、ADFバインド・タスク・フローの主要な機能をまとめます。
表14-2 ADFバインド・タスク・フローの機能
機能 | 説明 |
---|---|
明確に定義された境界 |
ADFバインド・タスク・フローは、プライベート制御フロー・ルール、アクティビティおよびマネージドBeanの独自のセットで構成されます。コール元は、バインド・タスク・フロー境界内におけるページ名、メソッド・コール、子バインド・タスク・フロー、マネージドBean、制御フロー・ルールなどの内部知識を必要としません。入力パラメータはバインド・タスク・フローに渡すことができ、出力パラメータは終了時にバインド・タスク・フローから渡すことができます。データ・コントロールはタスク・フロー間で共有できます。 |
単一エントリ・ポイント |
ADFバインド・タスク・フローには、タスク・フロー内の他のすべてのアクティビティの前に実行されるデフォルト・アクティビティである、単一のエントリ・ポイントがあります。詳細は、14.2.3項「ADFバインド・タスク・フローのデフォルト・アクティビティに関する必知事項」を参照してください。 |
ページ・フロー・メモリー・スコープ |
ADFバインド・タスク・フロー内でのデータの受渡し用に、ページ・フロー・スコープをメモリー・スコープとして指定できます。ページ・フロー・スコープは、ADFバインド・タスク・フローの各インスタンスに対して、一意の記憶域を定義します。その存続期間はADFバインド・タスク・フローであり、requestスコープより長く、sessionスコープより短くなっています。詳細は、14.2.4項「タスク・フローのメモリー・スコープに関する必知事項」を参照してください。 |
アドレス可能 |
ADFバインド・タスク・フローにアクセスするには、バインド・タスク・フローのXMLソース・ファイルに記述されている一意の識別子とXMLソース・ファイルのファイル名を指定します。詳細は、15.6.8項「タスク・フロー・コール・アクティビティ追加時の処理」を参照してください。 |
再利用 |
アクティビティ・グループ全体を単一のエンティティ、つまりADFバインド・タスク・フローとして識別し、そのバインド・タスク・フローをADFリージョン内の別のアプリケーションで再利用できます。たとえば、Fusion Order Demoアプリケーションのホーム・ページ上のホット・アイテムおよび「買い物をスタート」タブでは、リージョン内に組み込まれたものと同じタスク・フローを使用しています。各リージョンに異なるパラメータが渡され、表示される製品のリストが決定します。詳細は、17.2項「ADFリージョンの作成」を参照してください。 また、既存のバインド・タスク・フローは、コールするのみで再利用できます。たとえば、あるタスク・フローは、タスク・フロー・コール・アクティビティまたはURLを使用して別のバインド・タスク・フローをコールできます。 また、タスク・フロー・テンプレートを使用して、様々なADFバインド・タスク・フローで再利用するための共通の動作を取得します。詳細は、18.13項「タスク・フロー・テンプレートの作成」を参照してください。 |
パラメータおよび戻り値 |
コール元は、ADFバインド・タスク・フローに入力パラメータを渡し、そこから戻り値を受け入れます。詳細は、16.3項「ADFバインド・タスク・フローへのパラメータの渡し方」を参照してください。 また、バインド・タスク・フロー間でデータ・コントロールを共有できます。詳細は、18.3項「タスク・フロー間のデータ・コントロールの共有」を参照してください。 |
トランザクション管理 |
ADFバインド・タスク・フローは、トランザクションの作業ユニットを表します。タスク・フローの開始時に、新規のトランザクションを作成するか、既存のものを結合するか、または既存のトランザクションの一部ではないかどうかを決定するオプションをバウンド側のタスク・フローに宣言的に指定できます。詳細は、18.4項「トランザクションの管理」を参照してください。 |
再開 |
再開できるかどうかを決定するオプションを、バインド側のタスク・フローで指定できます。詳細は、18.5項「バインド・タスク・フローの再開」を参照してください。 |
メタデータのオンデマンド・ロード |
ADFバインド・タスク・フロー・メタデータは、ADFバインド・タスク・フローの開始時にオンデマンドでロードされます。 |
セキュリティ |
ADFバインド・タスク・フローは、ユーザーが使用する際に必要な権限を定義することによってセキュリティ保護します。 |
タスク・フローは、アクティビティ、およびアクティビティ間の遷移を定義する制御フロー・ケースで構成されます。図14-5では、toView2
という制御フローは、ViewActivity1
とViewActivity2
間の遷移を定義しています。図14-5
のタスク・フローを実行すると、ViewActivity1
がViewActivity2より前に表示されます。
図14-5には、ViewActivity2
の後、ただしtaskflowCall1
バインド・タスク・フローのコール前に起動するメソッド・コール(methodCall1
)が含まれています。タスク・フロー内で、ページのレンダリング前後のメソッドなどのアクティビティを起動します。特定ページの外でメソッドを起動することによって、そのメソッドを必要としないその他のコンテンツ(別なタスク・フローなど)でそのページを再利用できるため、再利用が促進できます。
制御フロー・ルールは、JSFナビゲーション・ルールに基づきますが、その他の情報を取得します。JSFナビゲーションは常にページ間のものですが、制御フロー・ルールはアクティビティ間の遷移を示します。たとえば、制御フロー・ルールは、ビュー・アクティビティとそれ以降のメソッド・コール・アクティビティ間の遷移を示します。また、ページから別のタスク・フローに制御が渡されることを示すことができます。
セーブポイント・リストア・アクティビティ、タスク・フロー・リターン・アクティビティ、およびURLビュー・アクティビティは、制御フロー・ルールのソースにはできません。
制御フロー・ルールの基本構造は、JSFナビゲーション・ルールを模倣したものです。表14-3に、JSFナビゲーション・ルールから制御フロー・ルールへのメタデータのマップ方法を示します。
表14-3 JSFナビゲーション・ルールから制御フロー・ルールへのマッピング
JSFナビゲーション・ルール | 制御フロー・ルール |
---|---|
ナビゲーション・ルール |
制御フロー・ルール |
ビューID(自) |
アクティビティID(自) |
ナビゲーション・ケース |
制御フロー・ケース |
アクション(自) |
アクション(自) |
結果(自) |
結果(自) |
ビューID(至) |
アクティビティID(至) |
注意: ADFタスク・フローの使用時、faces-config.xml のナビゲーション・ルールではなく、ADFコントローラの制御フロー・ルールを使用してすべてのアプリケーションのナビゲーションを行います。ADFコントローラは、ADFコントローラ・メタデータ内に一致する制御フローがなければ、ナビゲーション処理を委譲します。ただし、ADF以外のコントローラのNavigationHandler によってナビゲーションを行った場合、すべてのADFコントローラ機能は保証されません。 |
ワイルドカード制御フロー・ルールは制御フローのfrom-activity-id
を表し、これには、後方ワイルドカード(foo*
)または単一ワイルドカード文字(*
)が含まれます。タスク・フロー内の任意のアクティビティからワイルドカード制御フロー・ルールに制御を渡す場合は、単一ワイルドカード文字を使用します。あるいは、ワイルドカード制御フロー・ルールに制御を渡すアクティビティを制限する場合は、後方ワイルドカードを使用します。
図14-6では、ワイルドカード制御フロー・ルールに単一ワイルドカード文字が含まれており、タスク・フロー内のどのアクティビティからでもタスク・フロー・ダイアグラムで接続先となっているアクティビティに制御を渡せることを示しています。
図14-7の後方ワイルドカードは、activity-id
がstorefront
という文字で始まる有効なソース・アクティビティからloginPage
ビューに制御フローを渡せることを示しています。
タスク・フローはタスク・フロー自体と、複数のアクティビティ、そしてそれらのアクティビティ間の制御フロー・ルールで構成されています。ほとんどの場合は、アクティビティの多くがフロー内の異なるページを示すビュー・アクティビティです。たとえばページのレンダリング前などに、あるメソッドや操作をコールする場合、そのアクティビティから次の適切なアクティビティへの制御フローを定義した、メソッド・コール・アクティビティを使用します。別なタスク・フローをコールする場合は、タスク・フロー・コール・アクティビティを使用します。フローになんらかのブランチ化が必要な場合は、ルーター・アクティビティを使用します。バインド・タスク・フローの最後で、リターン・アクティビティを使用してフローを終了し、そのバインド・タスク・フローをコールしたフローに制御を戻します。
注意: アプリケーションがビュー・レイヤーでのFacelets XHTMLファイルを使用している場合、タスク・フローのソース・ファイルで、これらのFacelets XHTMLファイルを参照するビュー・アクティビティ間のナビゲーションを手動で構成します。 |
各コンポーネント用のメタデータと設定可能な追加構成を含む、タスク・フローの各コンポーネントの詳細および手順は、14.3項「タスク・フローへのアクティビティの追加」を参照してください。
ADFのバインド・タスク・フローと無制限タスク・フローを作成するプロセスは類似しています。主な相違は、「タスク・フローの作成」ダイアログの「バインド・タスク・フローとして作成」チェック・ボックスを選択してADFバインド・タスク・フローを作成する点です。
注意: プロジェクトの作成時は、無制限タスク・フローを作成する必要はありません。「プロジェクト・プロパティ」ダイアログの「テクノロジ・スコープ」ページで、「ADFページ・フロー」を指定している場合は、プロジェクト内で新しいadfc-config.xml ソース・ファイルが自動的に作成されます。adfc-config.xml ソース・ファイルは、無制限タスク・フローの主なソース・ファイルです。 |
タスク・フローの作成方法:
タスク・フローの作成:
アプリケーション・ナビゲータで、タスク・フローを作成するプロジェクトを右クリックして、「新規」を選択します。
「新規ギャラリ」でWeb Tierを展開し、「JSF」、「ADFタスク・フロー」の順に選択し、「OK」をクリックします。
図14-8に示すダイアログが表示されます。
「タスク・フローの作成」ダイアログでは、デフォルトで「バインド・タスク・フローとして作成」チェック・ボックスが選択されています。アプリケーションのバインドなしタスク・フローに組み込まれるソース・ファイルを作成するには、チェック・ボックスの選択を解除します。
チェック・ボックスの選択を解除すると、「ファイル名」フィールドのデフォルト値が自動的に変更されます。この値は、作成するADFタスク・フローのXMLソース・ファイルの名前に使用されます。XMLソース・ファイルには、タスク・フローのアクティビティおよび制御フロー・ルールを記述するメタデータが含まれます。
ヒント: 無制限タスク・フローのデフォルト名は、adfc-config.xml です。バインド・タスク・フローのデフォルトのソース・ファイル名は、「タスク・フローID」フィールドに指定された値と一致します。 |
1つのプロジェクトには複数のタスク・フローを含めることができるので、ソース・ファイルに一意の名前を付けるために、「ファイル名」フィールドのデフォルト値に数字が追加されます(task-flow-definition3.xml
など)。
タスク・フローに追加するビュー・アクティビティでJSFページを参照する場合は、デフォルトで選択されている「ページ・フラグメントを使用して作成」チェックボックスをクリアします。タスク・フローに追加するビュー・アクティビティでページ・フラグメント・ファイル(.jsff)を参照する場合は、「ページ・フラグメントを使用して作成」
チェックボックスを選択したままにします。
「OK」をクリックします。
タスク・フローを表すダイアグラムがエディタに表示されます。
ヒント: タスク・フロー・ダイアグラム全体のサムネイルは、ダイアグラムをクリックし、メイン・メニューで「表示」→「サムネイル」を選択すると表示できます。 |
タスク・フローの作成後、ダイアグラム、概要およびソース・エディタを使用して更新できます。
タスク・フローの更新には、「構造」ウィンドウも使用できます。
ヒント: タスク・フローの作成には、既存のADFタスク・フローを新規のタスク・フローにリファクタするなどの別の方法もあります。詳細は、14.5項「新規ADFタスク・フローおよびテンプレート作成のためのリファクタ」を参照してください。 |
コンポーネント・パレットの「ADFタスク・フロー」ページから、アクティビティをダイアグラムにドラッグします。通常は、ビュー・アクティビティから開始します。あらゆるタイプのアクティビティの詳細手順は、14.3.1項「ADFタスク・フローへのアクティビティ追加方法」を参照してください。
ダイアグラム上にビュー・アクティビティをドラッグすると、アクティビティをダブルクリックして、タスク・フローによる起動が設定されているページまたはページ・フラグメントのウィザードを表示できます。このウィザードを使用してページまたはページ・フラグメントの特性を定義します。詳細は、15.2項「ビュー・アクティビティの使用」を参照してください。
注意: アプリケーション・ナビゲータからタスク・フローのダイアグラム上にページをドラッグ・アンド・ドロップして、タスク・フローにビュー・アクティビティを追加することもできます。 |
ルーター・アクティビティをダイアグラムにドラッグすると、プロパティ・インスペクタを使用して、どの制御フローに従うのかを判断するための式を作成できます。詳細は、15.4項「ルーター・アクティビティの使用」を参照してください。
コール・アクティビティをダイアグラム上にドラッグすると、プロパティ・インスペクタを使用して、コールするメソッドを構成できます。詳細は、15.5項「メソッド・コール・アクティビティの使用」を参照してください。
ダイアグラム上にタスク・フロー・アクティビティをドラッグすると、アクティビティをダブルクリックして、新しいバインド・タスク・フローの設定を定義できる「バインド・タスク・フローの作成」ウィザードを表示できます。詳細は、15.6項「タスク・フロー・コール・アクティビティの使用」を参照してください。
バインド・タスク・フローを作成し、ダイアグラム上にタスク・フロー・リターン・アクティビティをドラッグすると、プロパティ・インスペクタを使用してアクティビティを構成できます。詳細は、15.7項「タスク・フロー・リターン・アクティビティの使用」を参照してください。
アクティビティ間の制御フロー・ケースを作成します(詳細および詳細な手順は、14.3.3項「制御フローの追加方法」を参照してください)。
コンポーネント・パレットの「ADFタスク・フロー」ページで、「制御フロー・ケース」を選択します。
ダイアグラムで、ビューなどのソース・アクティビティをクリックし、次にターゲット・アクティビティをクリックします。たとえば図14-15では、制御フローに2つのアクティビティがリンクされています。ソースとターゲットの両方(view1
およびview2
)のアクティビティがリンクされています。
「アクション(自)」属性(結果がメソッドによって決定する場合)または「結果(自)」属性(結果をString
として設定可能な場合)を使用して結果値を設定します。
バインド・タスク・フローを作成する場合、いずれかのアクティビティをデフォルトに指定できます。そうすることで、タスク・フローの実行時に常に特定のアクティビティを最初に実行できます。デフォルトでは、タスク・フローに最初に追加したアクティビティがデフォルトになります。別なアクティビティに変更する場合は、ダイアグラム内で該当するアクティビティを右クリックし、「アクティビティのマーク」→「デフォルト・アクティビティ」の順に選択します。詳細は、14.2.3項「ADFバインド・タスク・フローのデフォルト・アクティビティに関する必知事項」を参照してください。
新規ADF無制限またはバインド・タスク・フローを作成するたびに、新しいXMLソース・ファイルが作成されます。デフォルトでは、ADF無制限タスク・フローのXMLソース・ファイルはadfc-config.xml
と呼ばれます。
例14-1に示すように、すべてのADFコントローラXMLソース・ファイルには、最上位の要素として<adfc-config>
が最初に表示されます。バインド・タスク・フロー、アクティビティおよび制御フロー・ルールは、<adfc-config>
要素の内部に定義されます。バインド・タスク・フローは、ソース・ファイル内で<task-flow-definition>
メタデータ要素によって識別されます。
例14-1 ADFバインド・タスク・フローのXMLソース・ファイル
<?xml version="1.0" encoding="windows-1252" ?> <adfc-config xmlns="http://xmlns.oracle.com/adf/controller" version="1.2" id="__1"> <task-flow-definition id="task-flow-definition"> <use-page-fragments/> </task-flow-definition> </adfc-config>
ADFバインド・タスク・フローは、識別子とドキュメント名の一意な組合せで構成されたタスク・フロー参照によって識別されます。例14-2は、タスク・フロー・コール・アクティビティ内のタスク・フロー参照の例を示しています。
例14-2 タスク・フロー参照
<adfc-config xmlns="http://xmlns.oracle.com/adf/Controller" version="1.2"> <task-flow-definition id="task-flow-definition"> <use-page-fragments/> . . <task-flow-call id="taskFlowCall"> <task-flow-reference> <document>/WEB-INF/target-task-flow-definition.xml</document> <id>my-task-flow</id> </task-flow-reference> </task-flow-call> . . </task-flow-definition> </adfc-config>
注意: JDeveloperを使用してADFバインド・タスク・フローを作成する場合、1つのバインド・タスク・フロー定義を表すIDを各ドキュメントに1つのみ指定します。 |
ADFバインド・タスク・フローを作成する場合、識別子とドキュメント名の両方を割り当てます。例14-2に示すように、識別子は、「タスク・フローID」フィールドの値です。ドキュメント名は、「ファイル名」フィールドの値です。
デフォルト・アクティビティは、ADFバインド・タスク・フローで実行される最初のアクティビティです。たとえば、デフォルト・アクティビティは、タスク・フロー・コール・アクティビティからADFバインド・タスク・フローに制御が渡されるとき、常に最初に実行されます。
ADF無制限タスク・フローにはデフォルト・アクティビティはありません。
図14-9に示すように、緑の円はタスク・フロー・ダイアグラムのデフォルト・アクティビティを示します。
新しいADFバインド・タスク・フロー・ダイアグラムに最初に追加するアクティビティが、デフォルト・アクティビティとして自動的に識別されます。タスク・フロー・ダイアグラム内の任意のアクティビティを右クリックし、「アクティビティのマーク」→「デフォルト・アクティビティ」の順に選択することもできます。デフォルトは任意のアクティビティ・タイプで、ADFバインド・タスク・フロー内の任意の場所に配置できます。デフォルト・アクティビティを検索するには、タスク・フロー・ダイアグラム上の任意の場所で右クリックし、「デフォルト・アクティビティに移動」を選択します。
ADFバインド・タスク・フローで使用できるデフォルト・アクティビティは1つのみです。デフォルトとして2つ目のアクティビティをマークすると、最初のマークが自動的に解除されます。アクティビティのマークを手動で解除するには、タスク・フロー上の任意のアクティビティを右クリックし、「アクティビティのマーク解除」→「デフォルト・アクティビティ」を選択します。
トレインの途中でトレイン・ストップをデフォルト・アクティビティとして指定しないでください(詳細は、18.11項「トレインの作成」を参照)。
例14-3に、バインド・タスク・フローのSurveyPrompt
というデフォルト・アクティビティのメタデータの例を示します。
Fusion Webアプリケーション内の各タスク・フローでは、状態を管理するためにpageFlowスコープを定義しています。pageFlowスコープはタスク・フローの開始時に始まり、タスク・フローの終了時に終わります。pageFlowスコープで定義する一意の記憶域は、タスク・フローのアクティビティ間でのデータの受渡しに使用するアプリケーション内でタスク・フローのインスタンスごとに定義されます。あるタスク・フローが別なタスク・フローをコールする際、呼出し側のタスク・フローは呼出される側のpageFlowスコープにアクセスします。したがって、たとえば、タスク・フローのビュー・アクティビティが参照するページ上のUIコンポーネントでは、たとえこのタスク・フローがUIコンポーネントと同じページに組み込まれたADFリージョンであっても、別のタスク・フローのpageFlowスコープにアクセスできません。
タスク・フローには複数のマネージドBeanを登録できます。図14-10に、デフォルトのバインドなしタスク・フロー(adfc-config.xml
)および顧客が登録したタスク・フローが、各種のスコープ値を使用して複数のマネージドBeanを参照している、Fusion Order Demoアプリケーションの例を示します。マネージドBeanに割り当てられたスコープを特定できます。
表14-4に、マネージドBeanに使用可能なスコープを示します。また、タスク・フローに登録したマネージドBeanにおける各スコープの使用に適した状況も説明します。この表はスコープを存続期間順に示しています。たとえば、アプリケーション・スコープは、リクエスト・スコープよりも存続期間が長くなっています。
表14-4 ADFマネージドBeanのメモリー・スコープ
スコープ | 説明 |
---|---|
アプリケーション |
アプリケーション・スコープはアプリケーション終了時まで続行します。このスコープのマネージドBeanに保存する値は、そのアプリケーションを使用する各セッションと各リクエストで使用できます。 タスク・フローに使用すると、タスク・フローが終了しても存続してしまうので、避けてください。 |
セッション |
セッション・スコープはユーザーがアプリケーション内のページに最初にアクセスしたときに始まり、非アクティブ状態になった場合、またはアプリケーションによるセッション認証が失敗した場合に、ユーザー・セッションがタイムアウトしたときに終了します。 このスコープは、セッション全体に関連する情報(ユーザー情報やコンテキスト情報など)にのみ使用します。タスク・フロー間で値を渡すためにセッション・スコープを使用しないでください。タスク・フロー間での値のやり取りには、パラメータを使用します。パラメータを使用すると、タスク・フローは、コール元あるいはコール先となる他のタスク・フローと明確に結ばれます。セッション・スコープの使用を避けるもう1つの理由は、タスク・フローが終了しても存続する可能性がある点です。 |
pageFlow |
タスク・フロー内のアクティビティ全体でマネージドBeanにアクセスできるようにしたい場合は、このスコープを選択します。pageFlowがあるマネージドBeanは、それにアクセスするタスク・フローのページと同じ状態にあります。pageFlowスコープが指定されたマネージドBeanはタスク・フローが終了するまで存続します。別なタスク・フローのページからマネージドBeanへの参照が行われた場合、マネージドBeanがこのオブジェクトの別なインスタンスを作成し、それをそのタスク・フローのpageFlowスコープに追加します。 |
ビュー |
このスコープは、現在のビュー・アクティビティ内でのみ必要とされ、ビュー・アクティビティ間をまたがっていないマネージドBeanオブジェクトに使用します。ADFコントローラが管理する各ビュー・ポート、たとえばルート・ブラウザ・ウィンドウまたはADFリージョンなどのスコープを定義します。 このスコープの存続期間は、ビュー・ポートの現在の |
リクエスト |
リクエスト・スコープは、現在のリクエストより長期間、マネージドBeanが存続する必要がない場合に使用します。 |
backingBean |
バッキングBeanは、JSFページ上のUIコンポーネントのアクセッサとイベント処理コードを保存するマネージドBeanの記述規則です。リクエストが終了するまで存続するもので、状態の維持には使用しないでください。 タスク・フローが同じJSFページの複数のADFリージョンに表示される可能性がある場合に、ADFリージョンの各インスタンスを分離するために使用します。 |
タスク・フローにマネージドBeanを登録すると、JDeveloperがタスク・フローのソース・ファイル内に次のようなエントリを生成します。
<managed-bean id="__15">
<managed-bean-name id="__16">egBackingBean</managed-bean-name>
<managed-bean-class id="__13">oracle....egBackingBean</managed-bean-class>
<managed-bean-scope id="__14">backingBean</managed-bean-scope>
</managed-bean>
<managed-bean-scope>
要素には、マネージドBeanのスコープの値(例ではbackingBean
)が含まれています。
UIコンポーネントをマネージドBeanにバインドすると、JDeveloperはマネージドBeanの参照用に生成するEL式のスコープ名にScope
を付加します。たとえば、マネージドBeanを参照する表コンポーネントのバインド属性には次のEL式があります。
<af:table id="cartTab"
...
binding="#{backingBeanScope.egBackingBean.table}"
...
</af:table>
UIコンポーネントのバインド属性で参照するマネージドBeanのスコープを、backingBeanまたはリクエスト・スコープに限定します。UIコンポーネントのインスタンスはシリアライズできません。backingBeanとリクエスト以外のスコープのオブジェクトは、シリアライズ可能と考えられています。そのため、backingBeanまたはリクエスト以外のスコープのマネージドBeanに、UIコンポーネントをバインドしてはなりません。JDeveloperでは、UIコンポーネントのバインディング属性およびリージョン・フラグメントが、backingBeanスコープを使用するようにデフォルト設定されています。
注意: Oracle ADF固有のカスタム・スコープ(pageFlow、backingBean、ビュー・スコープなど)にアクセスするEL式を記述する場合、アクセスするスコープを明示的に指定するEL式を記述します。たとえばpageFlowスコープにアクセスするEL式は次のように記述します。
|
1つのアプリケーションで、複数のADF無制限タスク・フローXMLソース・ファイルと複数のADFバインド・タスク・フローXMLソース・ファイルを持つことができます。ADF無制限タスク・フローを生成するために組み合せたファイル・セットは、アプリケーションのADFコントローラ・ブートストラップ構成ファイルと呼ばれています。ADF無制限タスク・フローは、1つ以上のADFコントローラ・ブートストラップ構成ファイルを組み合せて、実行時にアセンブルされます。ADFバインド・タスク・フロー内にないブートストラップ構成ファイルのすべてのアクティビティは、ADF無制限タスク・フロー内にあるとみなされます。
1つのアプリケーション内のソース・ファイル名は、異なる名前である必要があります。図14-11の例には、2つのバインドなしタスク・フロー(adfc-config
、adfc-config2
)と、1つのバインド・タスク・フロー(task-flow-definition
)があります。
タスク・フローの作成後、タスク・フローにアクティビティを追加し、アクティビティ間の制御フローを構成します。JDeveloperの「コンポーネント・パレット」に、使用可能なアクティビティおよび制御フローが表示されます。「コンポーネント・パレット」からタスク・フロー・ダイアグラムに、アクティビティおよび制御フローをドラッグ・アンド・ドロップします。次にアクティビティ間の制御フローを構成し、タスク・フローが必要なタスクを実行できるようにします。
タスク・フローを作成すると、タスク・フロー・ダイアグラムとコンポーネント・パレットが自動的に表示されます。タスク・フロー・ダイアグラムはビジュアル・エディタであり、そこでタスク・フローのアクティビティおよび制御フローを追加できます。これは、コンポーネント・パレットからドラッグしてダイアグラムに追加できます。
アクティビティをADFタスク・フローに追加するには:
アプリケーション・ナビゲータで、タスク・フロー・ソース・ファイルをダブルクリックします。
たとえば、図14-12はタスク・フロー・ソース・ファイル(task-flow-definition.xml
)をダブルクリックすると自動的に表示されるエディタおよび「コンポーネント・パレット」を示します。
コンポーネント・パレットの「ADFタスク・フロー」ページから、アクティビティをダイアグラムにドラッグします。
ビュー・アクティビティをダイアグラム上にドラッグすると、アクティビティをダブルクリックして「JSFページ・フラグメントの作成」ウィザードを表示し、そこでページまたはページ・フラグメントの特性を定義できます。詳細は、15.2項「ビュー・アクティビティの使用」を参照してください。
ダイアグラム上にタスク・フロー・アクティビティをドラッグすると、アクティビティをダブルクリックして、新しいバインド・タスク・フローの設定を定義できる「バインド・タスク・フローの作成」ウィザードを表示できます。詳細は、15.6項「タスク・フロー・コール・アクティビティの使用」を参照してください。
ヒント: タスク・フロー・ダイアグラムに各アクティビティをドラッグすると、アクティビティに関する追加情報を提供するオプションのステータス・アイコンとツールチップを表示できます。たとえば、タスク・フロー・ダイアグラムにビュー・アクティビティをドラッグすると、それをJSFページに関連付けるまで警告アイコンが表示されることがあります。アイコンをオンにするには、タスク・フロー・ダイアグラムの上部にある「表示」を選択し、続いて「ステータス」と次のいずれかを選択します。
2次アイコンの上にマウスをドラッグすると、アイコンの意味を説明するツールチップを表示できます。 |
図14-13に示すように、コンポーネント・パレットには、コンポーネントとダイアグラムの注釈用の別個のセクションがあります。「コンポーネント」セクションの内容は、作成対象がADFバインド・タスク・フローか、ADF無制限タスク・フローかに応じて若干異なります。たとえば、ADFバインド・タスク・フローを作成する場合、「コンポーネント」セクションには、追加のタスク・フロー・リターン・アクティビティがあります。
ADFタスク・フローに追加できるアクティビティは、表14-13を参照してください。
制御フロー・ケースは、アプリケーション内で、あるアクティビティから次のアプリケーションに制御を渡す方法を指定します。制御フローを作成するには、コンポーネント・パレットの「ADFタスク・フロー」ページで「制御フロー・ケース」を選択し、ソース・アクティビティからターゲット・アクティビティにドラッグします。2つのアクティビティ間で制御フロー・ケースをドラッグすると、次のもので構成される制御フローが自動的に作成されます。
control-flow-rule
: from-activity-id
を使用してソース・アクティビティを識別します。
control-flow-case
: to-activity-id
を使用してターゲット・アクティビティを識別します。
制御フロー・ケースのソースとしてアクティビティを識別すると、そのソースとしてアクティビティのある追加の制御フロー・ケースが、同じ制御フロー・ルールに基づいて構成されます。図14-14では、ソース・アクティビティとしてview1
を識別するcontrol-flow-rule
が1つ、ターゲット・アクティビティview2
およびview3
を識別するcontrol-flow-case
が2つあります。
ヒント: アクティビティを既存の制御フローにドラッグ・アンド・ドロップできます。これによって既存の制御フローが、アクティビティを中心として2つに分割されます。 |
1つの制御フロー・ルールに対して、複数の制御フロー・ケースが存在できます。
例14-4に、図14-14の複数の制御フロー・ケースのメタデータを示します。
例14-4 バインド・タスク・フロー内の制御フロー・ルールのメタデータ
<task-flow-definition id="task-flow-definition"> . . . <control-flow-rule> <from-activity-id>view1</from-activity-id> <control-flow-case> <from-outcome>toView2</from-outcome> <to-activity-id>view2</to-activity-id> </control-flow-case> <control-flow-case> <from-outcome>toView3</from-outcome> <to-activity-id>view3</to-activity-id> </control-flow-case> </control-flow-rule> . . . </task-flow-definition>
アクティビティ間の基本的な制御フロー作成の開始ポイントとして、タスク・フロー・ダイアグラムを使用します。その後、タスク・フロー・ダイアグラムの「構造」ウィンドウ、プロパティ・インスペクタまたは概要エディタで制御フロー・プロパティを編集できます。
タスク・フロー・ダイアグラムで制御フロー・ケースを直接定義するには:
アプリケーション・ナビゲータで、タスク・フロー・ソース・ファイル(adfc-config.xml
など)をダブルクリックして、タスク・フロー・ダイアグラムを表示します。
コンポーネント・パレットの「ADFタスク・フロー」ページで、「制御フロー・ケース」を選択します。
ダイアグラムで、ビューなどのソース・アクティビティをクリックし、次にターゲット・アクティビティをクリックします。たとえば図14-15では、制御フローに2つのアクティビティがリンクされています。ソース(view1
)とターゲットの両方のアクティビティがリンクされています。
ダイアグラムに制御フロー・ケースが追加されます。アクティビティ間に追加された各線は、制御フロー・ケースを表します。矢印は、制御フロー・ケースの方向を示します。from-outcome
には、UIコンポーネントのaction
属性に指定された値と照合される値が含まれています。
from-outcome
を変更するには、ダイアグラムの制御フローの隣のテキストを選択します。図14-15に示すように、デフォルトでは、このテキストはワイルドカード(*)文字です。テキストは新規のfrom-outcome
(toView2
など)で上書きできます。
from-activity-id
(ソース・アクティビティを識別する)やto-activity-id
(ターゲット・アクティビティを識別する)を変更するには、ダイアグラムの矢印のどちらかの端を新規のアクティビティにドラッグします。
ヒント: タスク・フロー・ダイアグラムの制御フローを選択すると、プロパティ・インスペクタや「構造」ウィンドウでそのプロパティを変更することもできます。「構造」ウィンドウは、制御ルールとケースの間の関連の表示に役立ちます。また、タスク・フロー・ダイアグラムの概要エディタの「制御フロー」をクリックしてケースを追加することもできます(図14-16を参照)。ケースを追加するには、ルールの「アクティビティ(自)」(ソース・アクティビティ)および「アクティビティ(至)」(ターゲット・アクティビティ)がタスク・フローに追加されていることを確認します。 |
バインドなしまたはバインド・タスク・フローにワイルドカード制御フロー・ルールを追加できます。追加の手順は、タスク・フロー・ダイアグラムへのアクティビティの追加の手順とほぼ同じです。
ワイルドカード制御フロー・ルールを追加するには:
アプリケーション・ナビゲータで、タスク・フロー・ソース・ファイル(adfc-config.xml
など)をダブルクリックして、タスク・フロー・ダイアグラムを表示します。
コンポーネント・パレットの「ADFタスク・フロー」ページから「ワイルドカード制御フロー・ルール」をドラッグして、タスク・フロー・ダイアグラムにドロップします。
コンポーネント・パレットの「ADFタスク・フロー」ページから、「制御フロー・ケース」を選択します。
タスク・フロー・ダイアグラムで、制御フロー・ケースをワイルドカード制御フロー・ルールからターゲット・アクティビティにドラッグします。
ターゲットはどのアクティビティ・タイプでもかまいません。
デフォルトでは、ワイルドカード制御フロー・ルールの下のラベルは*であり、これはそのfrom-activity-id
値の単一の*文字に相当します。この値を変更するには、ダイアグラムでワイルドカード制御フロー・ルールを選択します。ワイルドカード制御フロー・ルールのプロパティ・インスペクタで、 「アクティビティID(自)」フィールドに新しい値を入力します。たとえば、project*
と入力します。新しいラベルでは、ワイルドカードは後続の文字である必要があります。
ヒント: from-activity-id 値は、タスク・フロー・ダイアグラムの概要エディタで変更することもできます。 |
タスク・フローのソース・ファイルにあるルールを定義する要素を理解すると、ADFタスク・フロー・ダイアグラム、ADFタスク・フローの概要エディタ、または「構造」ウィンドウで制御フロー・ルールを直接作成する際、あるいはXMLソース・ファイルに直接追加する際に役立ちます。例14-5に、タスク・フロー・ソース・ファイルの制御フロー・ルール要素の一般的な構文を示します。
例14-5 ソース・ファイルの制御フロー・ルールの構文
<control-flow-rule> <from-activity-id>from-view-activity</from-activity-id> <control-flow-case> <from-action>actionmethod</from-action> <from-outcome>outcome</from-outcome> <to-activity-id>destinationActivity</to-activity-id> </control-flow-case> <control-flow-case> . . . </control_flow-case> </control-flow-rule>
制御フロー・ルールは、次のメタデータで構成されます。
control-flow-rule
: 制御フロー・ケース要素の必須ラッパー要素。
from-activity-id
: 制御フロー・ルールの発生元となるアクティビティの識別子(source
など)。
from-activity-id
の後方ワイルドカード(*)文字がサポートされています。ルールは、ワイルドカードのパターンに一致するすべてのアクティビティに適用されます。たとえば、login*
は、リテラルlogin
で始まるすべての論理アクティビティID名と一致します。メタデータに(後方ワイルドカードではなく)単一のワイルドカード文字を指定すると、ダイアグラムで、制御フローが自動的にワイルドカード制御フロー・ルール・アクティビティに変換されます。詳細は、14.3.4項「ワイルドカード制御フロー・ルールの追加方法」を参照してください。
control-flow-case
: 制御フロー・ルールの各ケースの必須ラッパー要素。それぞれのケースで、同じソース・アクティビティに対して異なる制御フローを定義します。制御フロー・ルールには、少なくとも1つの制御フロー・ケースが必要です。
from-action
: 指定されたアクション・メソッドからの結果のみにルールの適用を制限する任意の要素。アクション・メソッドは、ELバインディング式(#{backing_bean.cancelButton_action}
など)として指定されます。
例14-5では、outcome
がactionmethod
から返された場合にのみ制御がdestinationActivity
に渡されます。
from-action
の値は、ビュー・アクティビティから発生する制御フローのみに適用され、その他のアクティビティ・タイプからのものには適用されません。from-action
では、ワイルドカードはサポートされていません。
from-outcome
: 特定の元のアクティビティ結果に基づき、続いて起こる制御フロー・ケースを識別する要素。考えられるすべての元のアクティビティの結果は、制御フロー・ケースと適合する必要があります。
from-action
要素とfrom-outcome
要素の両方を空のままにすると、ケースはアクティビティに対して定義されたその他の制御フロー・ケースでは識別されないすべての結果に適用されるため、アクティビティのデフォルト・ケースが作成されます。from-outcome
では、ワイルドカードはサポートされていません。
to-activity-id
: 制御フロー・ケースが実行される場合にナビゲーションのルーティング先となるアクティビティの完全な識別子が含まれる必須要素。各制御フロー・ケースは、異なるto-activity-id
を指定できます。
実行時、ADFコントローラは、最も具体的な一致から最も具体的でない一致まで制御フロー・ルールを評価して、アクティビティ間の次の遷移を決定します。評価は次の優先度に基づきますが、これはJSFナビゲーション・ルールと類似しています。
from-activity-id
、from-action
、from-outcome
from-activity-id
、from-outcome
from-activity-id
ADFコントローラは、最初にfrom-activity-id
、from-action
、from-outcome
の3つの要素すべての一致を検索します。一致がない場合は、from-activity-id
およびfrom-outcome
要素のみの一致を検索します。最後に、from-activity-id
要素のみの一致を検索します。
ADFコントローラは、そのメタデータ内でリクエストと一致する制御フロー・ルールを検出できない場合、標準JSFナビゲーション・ハンドラによる一致の検出を許可します。
1つのバウンドなしタスク・フローに、ADFコントローラXMLソース・ファイルは複数存在できます。複数のADFコントローラXMLソース・ファイルに制御フロー・ルールを定義できるため、似たようなルールが異なるファイルに定義される場合もあります。2つ以上のケースに同じfrom-activity-id
、from-action
またはfrom-outcome
の値が存在するといった競合がある場合は、(adfc-config.xml
、ブートストラップまたはバインド・タスク・フローのソース・ファイルで記述される順序で)最後のケースが使用されます。異なるソース・ファイルに定義されたルール間で競合がある場合は、最後にロードされるソース・ファイルのルールが使用されます。
タスク・フローを実行してデバッグするプロシージャは、タスク・フローがバインドかバインドなしか、ページまたはページ・フラグメントのどちらを含んでいるか、入力パラメータを受け入れるかどうかに応じて異なります。
アプリケーションを初めて実行し、新しいドメインを統合WebLogic Serverで開始する際に、「デフォルト・ドメインの構成」ダイアログが表示されます。ダイアログを使用して新しいドメインの管理者パスワードを定義します。入力するパスワードは8文字以上で、数字が含まれている必要があります。
ページであるビュー・アクティビティを含むADFバインド・タスク・フローを実行またはデバッグできます。
ページ・フラグメントであるビュー・アクティビティを含むバインド・タスク・フローの実行方法の詳細は、14.4.2項「ページ・フラグメントを使用するバインド・タスク・フローの実行方法」を参照してください。
注意: ADFタスク・フロー・ダイアグラムまたはアプリケーション・ナビゲータでビュー・アクティビティを選択し、「実行」を選択すると、ADFバインド・タスク・フローを実行できます。ADFバインド・タスク・フローでは、ビューをデフォルト・アクティビティとして指定し、ADF無制限タスク・フローをアプリケーション・ナビゲータから実行する必要があります。詳細は、14.2.3項「ADFバインド・タスク・フローのデフォルト・アクティビティに関する必知事項」を参照してください。 ADFタスク・フローで実行される最初のアクティビティがビュー以外のアクティビティ・タイプである場合、ADFバインド・タスク・フローを使用する必要があります。 |
ページを使用するバインド・タスク・フローを実行またはデバッグするには:
タスク・フロー・ダイアグラムで、タスク・フローを右クリックし、「実行」または「デバッグ」を選択します。
ブラウザにそのURL (http://mymachine:8988/StoreFrontModule-StoreFrontUI-context-root/faces/home
など)を入力して、タスク・フローを直接実行することもできます。
アプリケーション・ナビゲータでバインド・タスク・フローを右クリックし、「実行」または「デバッグ」を選択できます。
ページ・フラグメントを使用するADFバインド・タスク・フローは、ADFリージョン内でのみ実行することを目的としています。ページ・フラグメントとは、別のJSFページのコンテンツとしてレンダリングされるJSF JSPドキュメントです。詳細は、17.1.3.1項「ページ・フラグメントおよびADFリージョン」を参照してください。
ページ・フラグメントを使用するバインド・タスク・フローを実行またはデバッグするには:
バインド・タスク・フローにバインドされたリージョンのあるJSFページを作成します。ページ・フラグメントを含むバインド・タスク・フローをJSFページにドロップすると、JDeveloperにより自動的に実行されます。
ページを参照するプロジェクトのバインドなしタスク・フローにビュー・アクティビティを作成します。詳細は、14.3.1項「ADFタスク・フローへのアクティビティの追加方法」を参照してください。
アプリケーション・ナビゲータまたはタスク・フロー・ダイアグラムでビュー・アクティビティを右クリックし、「実行」を選択します。
パラメータのあるバインド・タスク・フローを実行する前に、ページを含むバインド・タスク・フローを実行する必要があります。バインド・タスク・フロー入力パラメータの詳細は、第16章「タスク・フローのパラメータの使用」を参照してください。
入力パラメータ定義を含むバインド・タスク・フローを実行する手順:
JSFページは、アプリケーション・ナビゲータでページを右クリックし、「実行」を選択して実行できます。ただし、ボタンやリンクなどのナビゲーションUIコンポーネントがページに含まれている場合は、ナビゲーションが機能する保証はありません。
ナビゲーションを完全に機能させてJSFページを実行するには:
バインド・タスク・フローまたはバインドなしタスク・フローを作成します。詳細は、14.2.1項「タスク・フローの作成方法」を参照してください。
タスク・フローにビュー・アクティビティを追加します。詳細は、14.3.1項「ADFタスク・フローへのアクティビティの追加方法」を参照してください。
アプリケーション・ナビゲータで、実行するJSFページを選択し、タスク・フロー・ダイアグラムにあるビュー・アクティビティの上部にドロップします。
これにより、JSFページがビュー・アクティビティと関連付けられます。
ダイアグラムでビュー・アクティビティを右クリックし、「実行」を選択します。
無制限タスク・フローの実行やデバッグには、起動する特定のビュー・アクティビティを選択する必要があります。
ADF無制限タスク・フローでビュー・アクティビティを実行するには:
タスク・フロー・ダイアグラムで、ビュー・アクティビティを右クリックし、「実行」または「デバッグ」を選択します。
選択したビュー・アクティビティからバインドなしタスク・フローが実行されます。
単一のビュー・アクティビティ以外を選択している(あるいは何も選択していない)場合、「実行コンフィギュレーションの設定」ダイアログで1つ選択するように求められます。
実行構成には、タスク・フローで実行する最初のアクティビティなど、プロジェクトの実行方法を決定する設定が含まれます。1つのプロジェクトに対して1つ以上の実行構成を定義できます。実行構成内では、デフォルトの実行ターゲットとしてADFソース・ファイルを指定できます。プロジェクトを実行すると、ソース・ファイルが最初に実行されます。
デフォルトのタスク・フロー実行ターゲットを定義するには:
アプリケーション・ナビゲータでプロジェクトを選択します。
メイン・メニューから、「実行」→「アクティブな実行構成を選択」→「実行構成の管理」を選択します。
「実行構成の管理」ダイアログで「実行/デバッグ/プロファイル」を選択し、次に「新規」を選択します。
「新規」ダイアログで、新規実行構成の名前を入力します。
既存の構成に基づいて新規の構成を作成する場合は、「構成設定のコピー」ドロップダウン・リストで構成を選択します。
「OK」をクリックして、ダイアログを終了します。
「編集」をクリックします。
「構成の編集」ダイアログの「デフォルトの実行ターゲット」ドロップダウン・リストで、プロジェクトの実行時に最初に実行するADFタスク・フローのソース・ファイルを選択します。
タスク・フローを選択すると、(無制限タスク・フロー用の)ビュー・アクティビティや(バインド・タスク・フロー用の)入力パラメータを設定できます。
「構成の編集」ダイアログの左側のパネルで、「ADFタスク・フロー」をクリックします。
右側のパネルにある「タスク・フロー」ドロップダウン・リストで、実行ターゲットのあるADFタスク・フローを選択します。
無制限タスク・フローを実行している場合は、「実行構成の編集」ダイアログに「ターゲット・アクティビティの実行」リストが表示されます。アプリケーションで最初に実行するビュー・アクティビティを選択します。
「開く」をクリックします。
次にプロジェクトを実行する際、保存された実行構成が「実行」→「アクティブな実行構成を選択」メニューで利用可能になります。
入力パラメータを受け付ける用に設定されたバインド・タスク・フローを実行している場合は、バインド・タスク・フロー用に定義されたすべての入力パラメータの値を指定するセクションがダイアログに表示されます。詳細は、第14章「パラメータのあるバインド・タスク・フローの実行方法」を参照してください。
既存のアクティビティ、JSFページ・フローおよびJSFページを、新規のADFコントローラ・コンポーネント(ADFバインド・タスク・フローおよびタスク・フロー・テンプレートなど)に変換できます。
新規のADFバインド・タスク・フローは、既存のADFバインドまたは無制限タスク・フローで選択したアクティビティに基づいて作成できます。
選択されたアクティビティから新規のADFバインド・タスク・フローを作成するには:
エディタ内で、新規のタスク・フローで使用するアクティビティを含むADF無制限タスク・フローまたはバインド・タスク・フローを開きます。
タスク・フロー・ダイアグラムで1つ以上のアクティビティを選択します。
ヒント: ダイアグラムで複数のアクティビティを選択するには、マウスの左ボタンをクリックしたまま、アクティビティの上にカーソルをドラッグします。[Ctrl]キーを押しながらそれぞれのアクティビティを選択することもできます。 |
選択したものを右クリックして、「タスク・フローの抽出」を選択します。
「タスク・フローの作成」ダイアログが表示され、そこで新規ADFバインド・タスク・フローを作成できます。詳細は、14.2項「タスク・フローの作成」を参照してください。
実行すると、ADFバインド・タスク・フローがエディタに表示されます。表14-5に示すプロパティが、新規タスク・フローに自動的に設定されます。
表14-5 新規ADFバインド・タスク・フローで更新されるプロパティ
プロパティ | 値 |
---|---|
タスク・フロー定義ID |
「 タスク・フローの作成」ダイアログの「タスク・フローID」フィールドに入力した値。 |
デフォルト・アクティビティ |
すべての受信制御フロー・ケースのターゲットとして指定。複数のターゲットが存在する場合、エラーのフラグが立てられ、操作全体がロールバックされます。 |
制御フロー・ルール |
選択されたソース・アクティビティのある制御フロー・ケースは、新規のADFバインド・タスクに組み込まれます。ソース・アクティビティは、制御フローの発生元のアクティビティです。新規のADFバインド・タスク・フローには、次のタイプの制御フロー・ケースがあります。
|
元のタスク・フロー(新規タスク・フローの基礎として選択したアクティビティを含むタスク・フロー)で次のような変更が自動的に実行されます。
新規タスク・フロー・コール・アクティビティが、元のタスク・フローに追加されます。タスク・フロー・コール・アクティビティは、新規ADFバインド・タスク・フローをコールします。
選択されたアクティビティが元のタスク・フローから削除されます。
選択したアクティビティに関連付けられた既存の制御フロー・ケースが、元のタスク・フローから削除されます。これは新規の制御フロー・ケースに置き換えられます。
古いアクティビティに対する受信制御フロー・ケースは、新規タスク・フロー・コール・アクティビティにリダイレクトされます。
古いアクティビティからの送信制御フロー・ケースは、新規タスク・フロー・コール・アクティビティからリダイレクトされます。
JSFページ・フローで選択したページに基づいて、新規のADFバインド・タスク・フローを作成できます。フローの一部である(つまり、JSFナビゲーション・ケースによってリンクされる)ページのみが、新規タスク・フローでビュー・アクティビティに変換されます。
ページ・フローで選択したJSFページから新規のタスク・フローを作成する手順:
エディタ内で、新規バインド・タスク・フローで使用するページを含むページ・フローを開きます。
タスク・フロー・ダイアグラムで1つ以上のJSFページを選択します。
ヒント: ダイアグラムで複数の要素を選択するには、マウスの左ボタンをクリックしたまま、要素の上にカーソルをドラッグします。[Ctrl]キーを押しながらそれぞれの要素を選択することもできます。 |
選択したものを右クリックして、「ADFタスク・フローの生成」を選択します。
「タスク・フローの作成」ダイアログが表示され、そこで新規ADF無制限またはバインド・タスク・フローを作成できます。詳細は、14.2項「タスク・フローの作成」を参照してください。
既存のADFバインド・タスク・フローを無制限タスク・フローに変換するか、そこに含まれるビューがページまたはページ・フラグメントかどうかを変更することができます。表14-6に、それぞれの変換結果を示します。
表14-6 ADFバインド・タスク・フローの変換
変換 | 結果 |
---|---|
ADFバインド・タスク・フローを無制限タスク・フローに変換 |
パラメータ定義やトランザクションなど、バインドなしタスク・フローに対して無効なすべてのメタデータが失われます。 |
JSFページを使用するためのADFバインド・タスク・フローの変換 |
タスク・フロー内の任意のビュー・アクティビティに関連付けられたページ・フラグメントをJSFページに変換します。「ページ・フラグメントを保持」チェック・ボックスを選択している場合、古いページ・フラグメントは保存されます。新規のJSFページ名は、デフォルトで古いページ・フラグメント名になります。 |
ページ・フラグメントを使用するためのADFバインド・タスク・フローの変換 |
ADFバインド・タスク・フロー内のビュー・アクティビティに関連付けられたすべてのページをページ・フラグメントに変換します。「ページを保持」チェック・ボックスを選択している場合、古いページは保存されます。新規のページ・フラグメント名は、デフォルトで古いページ名になります。 |
ADFバインド・タスク・フローを変換するには:
エディタで、バインド・タスク・フロー・ダイアグラムを開きます。
アクティビティまたは制御フロー以外のダイアグラムの任意の場所を右クリックします。
「無制限タスク・フローへの変換」や「ページ・フラグメントを含むタスク・フローへの変換」などのメニュー項目を選択します。
バインド・タスク・フローにフラグメントが含まれている場合、メニュー項目は「ページを含むタスク・フローへの変換」になります。
表14-7に、タスク・フロー、アクティビティ、およびその他の関連ADFコントローラ機能の前提条件と制約を示します。
表14-7 ADFコントローラ機能の前提条件および制約
機能エリア | 前提条件/ 制約 |
説明 |
---|---|---|
ADFコントローラ・オブジェクトおよびダイアグラムのUI |
JSFビュー・レイヤー |
ADFコントローラはJSF 1.2環境でのみ動作します。OracleのWebベースのFusion Webアプリケーション戦略は、唯一のビュー・レイヤー・テクノロジとしてJSFに焦点を当てています。 |
ADF Facesへの依存 |
ADFコントローラ拡張機能はADF Faces上に実装されています。この機能はADF Facesライブラリに依存しますが、これらのライブラリが存在する場合はJSF実装に対して実行できます。 |
|
カプセル化されたナビゲーションおよび状態管理 |
ADFコントローラでは、ナビゲーションと(ある程度までの)状態管理もカプセル化します。JSFおよびサーブレットAPIは、現在もアプリケーション、セッションおよびリクエストのレベルでの基本の状態管理に利用できます。 |
|
モデル・レイヤー |
ADFモデル・レイヤーは、アプリケーションのモデル・レイヤーの実装に使用されます。 |
|
MDSへの依存 |
ADFコントローラ・メタデータはMDSに保存されます。ただし、MDSは現在 MDSが提供しているカスタマイズ機能が必要な場合は、ADFタスク・フローを占有使用してマネージドBeanと制御フロー・ルールの定義を行う必要があります。 |
|
StrutsまたはModel 1からの移行パスのサポートなし |
StrutsまたはModel 1からFusion ADF Controllerへの移行はサポートされていません。 しかし、JSFページ・フローで選択したページに基づいて、新規のADFバインド・タスク・フローを作成できます。詳細は、14.5.2項「JSFページからのタスク・フローの作成方法」を参照してください。 |
|
バインド・タスク・フロー |
ページ・フロー・スコープ状態として公開 |
ADFコントローラは、ページ・フロー・スコープの状態の実装を管理します。フレームワークによって提供される自動管理機能(「戻る」ボタンのサポート、状態のクリーンアップ機能など)は、ページ・フロー・スコープのデータを想定しています。アプリケーションでそのページのすべてに対してこのような機能を完全実装するために、必要に応じてネストされたバインド・タスク・フローを使用して、アプリケーション全体をADFバインド・タスク・フローとして公開します。アプリケーションには、ページ・フロー・スコープ内にバージョニングを必要とする状態が格納されます。 |
トランザクション境界 |
開発者は、ADFバインド・タスク・フローを使用してトランザクション境界を管理します。 |
|
ページ・フロー・スコープ |
ADFライフサイクル内のアクセスの可用性 |
ADFコントローラでアクセス準備ができる前のADFライフサイクルの初期段階では、アプリケーションによるページ・フロー・スコープへのアクセスは試行できません。 ページ・フロー・スコープは、ビューのリストア・フェーズでBefore ListenerおよびAfter Listenerが実行されるまでは、アクセス可能になるとは保証されていません。ADFコントローラは、ビューのリストア・フェーズでBefore ListenerおよびAfter Listenerを使用して、サーバー側の状態をリクエストと同期化させます。ここでは、ブラウザの「戻る」ボタン検出やブックマーク参照解除などが処理されます。 |
ナビゲーション |
ナビゲーション |
ADFコントローラの使用時、 ADFコントローラはADFコントローラ・メタデータ内に一致する制御フロー・ケースがない場合にナビゲーション処理を委譲しますが、ADF以外コントローラ以外の |