Oracle JDeveloper 12c（12.1.2）チュートリアル - EJB、JPA、JavaServer Facesを使用したWebアプリケーションの構築

パート3：UIへの新規メソッドの追加と公開

ここでは、EJBのアノテーション・テクニックを使用して、Entity Beanに新しいメソッドを追加します。その後で、この新規メソッドをファサードに公開し、バウンド・タスク・フロー内でページに対するデータ・コントロールとして使用します。

また、このタスク・フローをmainHRページ内のリージョンとして使用することもできます。

ステップ1：エンティティへの新規メソッドの追加と公開

EJBでは、@NamedQueriesアノテーション構文を使用して、名前付き問合せを追加します。

すべてのタブを閉じ、「Model」プロジェクトを展開します。
「Employees.java」クラスをダブルクリックして、ソース・エディタで開きます。

これらのオブジェクトが他のJavaファイルと異なる点は、EJBエンティティとしてオブジェクトを識別するアノテーションがあることです。 EJB 3.0およびJPAのおもな特長は、古いバージョンのデプロイメント・ディスクリプタの代わりにメタデータ・アノテーションを使用して、オブジェクト・リレーショナル・マッピングを含むエンティティを作成できることです。

ソース・エディタで「Entity」ノードを展開し、@NamedQueriesアノテーション内の@NamedQuery文を表示します。
")

名前付き問合せを使用すると、設計時に問合せを定義し、実行時に使用できます。ファサードBeanを作成すると、NamedQueryメタデータ文がEmployeeエンティティ内に1つ作成されます。この問合せは、Employees表からすべての行を取得します。
@NamedQueries({ @NamedQuery(name = "Employees.findAll", query = "select o from Employees o") })

NamedQuery文の閉じ括弧の後にカンマを追加し、[Enter]キーを押して新しい行を追加します。
パラメータ値よりも高い給与の従業員のデータを取得する問合せをクラスに追加します。以下のコードを追加します。

@NamedQuery(name = "Employees.findBySal", query = "select o from Employees o where o.salary > :p_sal")

コードは次のようになります。

@NamedQueries( {
@NamedQuery(name = "Employees.findAll", query = "select o from Employees o") ,
@NamedQuery(name = "Employees.findBySal", query = "select o from Employees o where o.salary > :p_sal")
})

必要に応じて、[Alt]キーを押しながら[Enter]キーを押して、javax.persistence.NamedQueriesライブラリをインポートします。

@で始まるJavaコードの記号は、アノテーションと呼ばれます。アノテーションを使用すると、メタデータをオブジェクトに追加できます。アノテーションの例は、以下のとおりです。

アノテーション	説明
@Entity	ファイルをEJB 3.0エンティティとして識別します
@NamedQuery	実行時にデータを取り出すために使用できる問合せです
@Table	エンティティ用のプライマリ表を指定します
@Id	どのプロパティがエンティティ用の識別子であるかを定義できます
@Column	永続プロパティまたはフィールド用のマップされた列を指定します
@ManyToOne	表間の外部キー・リレーションシップの種類を指定します
@JoinColumn	外部キー・リレーションシップ用の結合列と参照先列を指定します

Makeアイコンをクリックしてプロジェクトをコンパイルし、エラーが返されていないことを確認します。
アプリケーション・ナビゲータで「HRFacadeBean.java」を右クリックし、コンテキスト・メニューから「Edit Session Facade」を選択します。
Specify Session Facade Optionsで、先ほど作成した新規問合せ「getEmployeesFindBySal()」を選択し、「OK」をクリックします。
この操作により、先ほど追加した名前付き問合せが公開され、データ・コントロールとして使用できるようになります。
「」Save Allアイコンをクリックして作業内容を保存します。
DataControl.dcxをダブルクリックし、Data Control Registryで、「HRFacadeBean」ノードを展開します。「employeesFindBySal」ノードをクリックし、EJB JPA定義に該当する既存の属性があることを確認します。
これで、新規メソッドをページ内のデータ・コントロールとして使用する準備が整いました。
「」Save Allアイコンをクリックして作業内容を保存します。

ステップ2：2つのJSFページを使用したバウンド・タスク・フローの構築

ADFタスク・フローは、Fusion Webアプリケーションにコントロール・フローを定義するためのモジュール・アプローチを提供します。

アプリケーション・ナビゲータで、「Model」プロジェクトを閉じます。「ViewController」プロジェクトを右クリックして、「New」→「From Gallery」を選択します。
New Galleryで、「Web Tier」→「JSF/Facelets」カテゴリを選択し、「ADF Task Flow」項目を選択します。「OK」をクリックします。
Create Task FlowダイアログにfindBySalFlow.xmlと入力します。ページ断片を使用してバウンド・タスク・フローを作成します。「OK」をクリックします。

ADFタスク・フローには次の2種類があります。

アンバウンド・タスク・フロー：ユーザーがタスクを完了するために相互作用する、アクティビティ、コントロール・フロー・ルール、マネージドBeanの集合。アンバウンド・タスク・フローは、バウンド・タスク・フロー内には含まれない、アプリケーション内のすべてのアクティビティおよびコントロール・フローから構成されます。

バウンド・タスク・フロー：特殊な形式のタスク・フローであり、アンバウンド・タスク・フローとは対照的に1つのエントリ・ポイント（エントリ・ポイントは、ブラウザから直接リクエストできるビュー・アクティビティです）とゼロまたは1つ以上のエグジット・ポイント（出口点）を含みます。バウンド・タスク・フローには、それぞれ固有のプライベート・コントロール・フロー・ルール、アクティビティ、マネージドBeanが含まれます。バウンド・タスク・フローは再利用、パラメータ、トランザクション管理、再入力に対応しており、JSFページ内のADFリージョンにレンダリングすることができます。

Create with Page Fragments：タスク・フローに追加するビュー・アクティビティからJSFページを参照しており、このJSFページがメインのブラウザ・ウィンドウ内にルート・ページとしてレンダリングされる場合、このチェック・ボックスの選択を解除します。タスク・フローに追加するビュー・アクティビティからページ断片ファイル（.jsff）を参照しており、タスク・フローによって実行時にこのファイルがADFリージョン内に表示される場合は、Create with Page Fragmentsチェック・ボックスを選択したままにします。

コンポーネント・パレットからタスク・フローに「View」コンポーネントをドラッグ・アンド・ドロップします。
2つ目の「View」コンポーネントをタスク・フローにドラッグ・アンド・ドロップします。

view1の周りに表示される円は、タスク・フロー内のエントリ・ポイントを表しています。

バウンド・タスク・フローには単一エントリ・ポイントであるデフォルト・アクティビティが含まれます。このアクティビティは、タスク・フロー内のその他すべてのアクティビティより先に実行されます。

「Control Flow Case」コンポーネントを選択し、「view1」を1回クリックしてコントロール・フロー・ケースの開始アクティビティを選択して、さらに「view2」をクリックします。このフローの名前をfindに変更します。
この操作を繰り返し、view2からview1へ、2番目のControl Flow Caseを作成し、backという名前に変更します。
「view1」をダブルクリックして、このビュー・アクティビティに関連付けるページを作成します。Create ADF Page Fragmentダイアログで、Document TypeがFacelets、Page LayoutがCreate Blank Pageになっていることを確認します。「OK」をクリックして、ページを作成します。

ページ断片は、別のJSFページ内にコンテンツとしてレンダリングされるJSFドキュメントです。通常、ページ断片は、JSFページにリージョンとして追加されるバウンド・タスク・フローで使用されます。
Data Controlsペインを開き、「employeesFindBySal」を展開します。「Operations」ノードを展開し、ページに「ExecuteWithParameters」をドラッグし、ADF Parameter Formとして追加します。
Create Formダイアログで、Display LabelフィールドにSalaryと入力し、「OK」をクリックしてその他のデフォルト値を受け入れます。
「ExecuteWithParameters」ボタンを選択し、プロパティ・インスペクタでActionプロパティのリストから「find」を選択し、TextにFindと入力します。
作業内容を保存します。
「findBySalFlow.xml」タブをクリックして、タスク・フロー・ダイアグラムを再表示します。タスク・フロー・ダイアグラムで、「view2」をダブルクリックして、view2ビュー・アクティビティに関連付けるページを作成します。
Create ADF Page Fragmentで、デフォルト値のまま「OK」をクリックします。
Data Controlsパレットで、ページに「employeesFindBySal」をドラッグし、「Table/List View」→「ADF Table」を選択します。
Edit Tableダイアログで、「Single Row」、「Enable Sorting」、「Enable Filtering」、「Read-Only Table」の各オプションを選択します。salaryの後にある列をすべて削除し、hiredateも削除します。「OK」をクリックして、表を作成します。
コンポーネント・パレットの「ADF Faces」→「General Controls」ライブラリで「Button」コンポーネントを選択し、Structureペインのaf:tableノード上にドロップします。
プロパティ・インスペクタで、TextにBackと入力し、Actionとして「back」を選択します。
「」Save Allアイコンをクリックして作業内容を保存します。

ステップ3：mainHRページ内リージョンとしてのタスク・フローの使用

JSFページまたはページ・フラグメント（.jsff）にバインド・タスク・フローをレンダリングするには、Oracle ADFリージョンを使用します。

アプリケーション・ナビゲータで「mainHR.jsf」ノードをダブルクリックし、mainHR.jsf ページを再表示します。
「Graph」タブを右クリックし、「Insert After Show Detail Item」→「Show Detail Item」を選択します。
プロパティ・インスペクタで、TextフィールドをSearchに変更します。
アプリケーション・ナビゲータで、「Web Content」→「Page Flows」を展開し、「findBySalFlow.xml」ノードをSearchペインにドラッグ・アンド・ドロップします。
コンテキスト・メニューから「Create」→「Region」を選択します。
ページ・リージョンは次のように表示されます。