| Oracle® Fusion Middleware Oracle Application Development Framework Webユーザー・インタフェース開発者ガイド 11g リリース1 (11.1.1.6.0) B52029-06 |
|
 前 |
 次 |
| Oracle® Fusion Middleware Oracle Application Development Framework Webユーザー・インタフェース開発者ガイド 11g リリース1 (11.1.1.6.0) B52029-06 |
|
前 |
次 |
この章では、ADF Facesの表、ツリーおよびツリー表コンポーネントを使用して表およびツリーを表示する方法を説明します。アプリケーションでFusionテクノロジ・スタックを使用する場合は、データ・コントロールを使用して表およびツリーを作成できます。詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』の「ADFによるデータバインドされた表の作成」および「マスター/ディテール・データの表示」の章を参照してください。
この章では、次の項目について説明します。
構造化データは、ADF Facesの表コンポーネントを使用して、行と列で構成される表として表示できます。階層データは、ADF Facesのツリー・コンポーネントを使用してツリー構造として表示することも、ADF Facesのツリー表コンポーネントを使用して表形式で表示することもできます。表示される各レコード用に子コンポーネントを含め、それらのコンポーネントを個々のレコードにバインドするかわりに、表、ツリーおよびツリー表コンポーネントが完全なコレクションにバインドされ、各レコードの値にスタンプを設定することにより、1つのコンポーネント(outputTextコンポーネントなど)が繰り返しレンダリングされます。たとえば、表に子の列コンポーネントが2つ含まれるとします。各列には、出力コンポーネントを使用して行の単一の属性値が表示され、4つのレコードが表示されます。データを表示するために、2つの出力コンポーネントの4セットをバインドするかわりに、表自体が4つすべてのレコードのコレクションにバインドされ、1セットの出力コンポーネントが単純に4回スタンプ設定されます。各行にスタンプが設定されると、現在行のデータが表のvar属性にコピーされ、出力コンポーネントが行の正しい値を取得できるようになります。特に、クライアント・コンポーネントでスタンプ設定がどのように機能するかの詳細は、10.1.5項「クライアントの表、ツリーおよびツリー表コンポーネントへのアクセス」を参照してください。
例10-1に、var属性の値がrowである表のJSFコードを示します。値が変数の特定のプロパティにバインドされているため、列の各outputTextコンポーネントにより行のデータが表示されます。
例10-1 値へのアクセスにvar属性を使用する表のJSFコード
<af:table var="row" value="#{myBean.allEmployees}">
<af:column>
<af:outputText value="#{row.firstname}"/>
</af:column>
<af:column>
af:outputText value="#{row.lastname}"/>
</af:column>
</af:table>
表コンポーネントは単純な表データを表示します。表の各行には、データベースの1行など、コレクションのオブジェクトが1つ表示されます。列コンポーネントは、各オブジェクトの属性の値を表示します。
たとえば、図10-1に示すように、File Explorerアプリケーションの表タブでは、選択されたディレクトリのコンテンツの表示に表が使用されています。表のvalue属性は、File ExplorerデモのtableContentViewマネージドBeanのcontentTableプロパティにバインドされています。
表コンポーネントは、列のソート、1行以上の選択、選択した行でのアプリケーション定義のアクションの実行など、エンド・ユーザーに様々な機能を提供します。また、グリッド線やバンディング、行ヘッダーと列ヘッダー、列のグループにまたがる列ヘッダー、およびセル内で折り返される値の表示など、多様な表示機能も用意されています。
File Explorerアプリケーションのディレクトリなどの階層データ(親子関係のあるデータ)は、ツリー・コンポーネントを使用して展開可能なツリーとして表示できます。項目は、データの親子の構造をミラー化するノードとして表示されます。トップレベルの各ノードを開いて子ノードを表示し、それを開いて、その子ノードを表示することもできます。開かれた各ノードを閉じて、子ノードを非表示にできます。図10-2に、ツリー・コンポーネントを使用して表示されているFile Explorerアプリケーションのファイル・ディレクトリを示します。
ツリー表コンポーネントを使用して、階層データも表示できます。ツリー表でも、展開および縮小可能な親子のノードを表示できますが、これは表形式で、ページにノードの属性値がデータの列として表示されます。たとえば、表コンポーネントを使用してディレクトリのコンテンツを表示するだけでなく、File Explorerアプリケーションには、図10-3に示すように、ツリー表コンポーネントを使用してコンテンツを表示する別のタブもあります。
ツリー・コンポーネント同様、ツリー表コンポーネントも、項目間の親子関係を表示できます。また、表コンポーネントと同じように、ツリー表コンポーネントでも列の項目の属性値を表示できます。ツリー表コンポーネントでも、表コンポーネントで使用可能なほとんどの機能を使用できます。
表、ツリーおよびツリー表をpanelCollectionコンポーネントで囲むことにより、ツールバーおよびステータス・バーを追加できます。上部のパネルには、メニューとメニュー・オプション、ツールバーとツールバー・ボタン、およびステータス・バーなど、メニュー・タイプのコンポーネントを保持するツールバーのみでなく、標準のメニュー・バーも含まれます。デフォルトで追加されているボタンおよびメニューもあります。たとえば、表、ツリーまたはツリー表をpanelCollectionコンポーネントで囲むと、表示メニューを含むツールバーが追加されます。このメニューには、表、ツリーまたはツリー表コンポーネントに固有のメニュー項目が含まれます。
図10-4に、panelCollectionコンポーネントを使用して作成されたツールバー、メニューおよびツールバー・ボタンのあるFile Explorerアプリケーションのツリー表を示します。
表、ツリーおよびツリー表コンポーネントは仮想化されており、サーバーのコンポーネントに存在するすべての行がクライアントに配信されて表示されるわけではありません。表、ツリーおよびツリー表を構成して、データ・ソースから一度に一定数の行をフェッチします。レンダリング時にすぐにデータをコンポーネントに配信したり、利用可能な場合は、コンポーネントのシェルがレンダリングされた後に遅延フェッチできます(コンポーネントでは、利用可能な場合はデフォルトでデータがフェッチされます)。
すぐに配信する場合は、最初のリクエスト時にデータがフェッチされます。遅延配信では、ページに表またはツリー・コンポーネントが1つ以上含まれる場合、ページで最初に標準のライフサイクルが実行されます。ただし、最初のリクエスト時にデータがフェッチされるのではなく、特別な個別の部分ページ・レンダリング(PPR)リクエストが実行され、表のフェッチ・サイズの値として設定された行数が戻されます。ページのレンダリング直後であるため、レンダー・レスポンス・フェーズのみがコンポーネントに対して実行され、対応するデータのフェッチおよび表示が可能になります。ユーザーのアクションにより後続のデータ・フェッチが実行される場合(別の行セットのために表をスクロールするなど)、別のPPRリクエストが実行されます。
コンテンツ配信が可能な場合に配信されるように構成した場合、フレームワークは最初のリクエスト時にデータ可能性をチェックし、利用可能な場合は、データを表に送信します。利用できない場合、データは遅延配信でロードされるため、別のPPRリクエスト時にロードされます。
|
パフォーマンスのヒント: 遅延の程度が高い遅いデータベース接続や、Webサービスなどのデータベース以外のデータ・ソースからのデータのフェッチなど、データ・フェッチで高コスト(遅い)の動作が予想される場合は、遅延配信を使用する必要があります。ページに表、ツリーまたはツリー表以外のコンポーネントが複数含まれる場合も、遅延配信を使用する必要があります。遅延配信を使用すると、データが使用可能になる前に、初期ページのレイアウト・コンポーネントおよびその他のコンポーネントが最初にレンダリングされます。 ページのコンテキストが表、ツリーまたはツリー表のみの場合や、コンポーネントに大規模なデータ・セットが戻される予定がない場合は、即時配信を使用する必要があります。この場合、遅延配信を使用するよりレスポンス時間が早くなりますが(または、単に早いと感じられる場合もあります)、これは、2番目のリクエストがサーバーに送信されないためで、ユーザーのレスポンス時間が早くなり、サーバーのCPU使用率も向上します。ただし、フェッチ・ブロックとして構成された数の行のみが最初に戻されることに注意してください。遅延配信同様、ユーザーのアクションにより後続のデータ・フェッチが実行される場合は、次の行セットが配信されます。 最初のレンダリング時にデータが利用できる場合はすぐに使用し、データが最初に利用できない場合は遅延にフォールバックするなど、可能な場合は配信でさらなる柔軟な操作が可能です。 |
クライアントに表示されるのは、ブラウザに表示される際にページに収まる行数のみです。ユーザーがコンポーネントを垂直にスクロールすると、行がさらにフェッチされます。コンポーネントを埋めるために1回でクライアントからサーバーにリクエストされる行数は、fetchSize属性により決定されます。デフォルト値は25です。そのため、表の高さが低ければ、フェッチ・サイズ25はコンポーネントを埋めるのに十分です。ただし、コンポーネントの高さが高い場合、サーバーからのデータのリクエストは複数回になります。そのため、fetchSize属性は大きな数に設定しておく必要があります。たとえば、表の高さが600ピクセルで、各行の高さが18ピクセルの場合、表を埋めるのに少なくとも45行必要です。fetchSizeが25の場合、表を埋めるために、表はサーバーに対してリクエストを2回実行する必要があります。この例では、フェッチ・サイズを50に設定します。
ただし、フェッチ・サイズを大きくしすぎると、サーバーとクライアントの両方に影響を与えます。サーバーでは、データ・ソースから必要以上に行がフェッチされ、時間とメモリー使用量が増加します。クライアント側では、それらの行の処理とコンポーネントへのアタッチに時間がかかります。
displayRow属性を使用して、最初に表示されるデータのセットを構成することもできます。デフォルトで、データ・ソースの最初のレコードが一番上の行またはノードに表示され、後続のレコードはそれより下の行またはノードに表示されます。また、ソースの最後のレコードを最初に表示するように、コンポーネントを構成することもできます。この場合、最後のレコードはコンポーネントの下の行またはノードに表示され、ユーザーは上にスクロールして先行するレコードを表示できます。また、選択した行を表示するように、コンポーネントを構成することも可能です。これは、ユーザーが表にナビゲートし、複数のパラメータに基づいて、特定の行がプログラムで選択される場合に便利です。選択された行を表示するように構成した場合、その行は表の先頭に表示され、ユーザーは上または下にスクロールして他の行を表示できます。
rowSelection属性を使用して、表、ツリーおよびツリー表で、行なし、単一行または複数行のいずれかになるように選択を構成できます。この設定により、選択された行でロジックを実行できます。たとえば、ユーザーが表の行またはツリーのノードを選択して、選択された行のデータが表示される別のページにナビゲートするコマンド・ボタンをクリックし、その値を編集できるようにするとします。
表、ツリーまたはツリー表の選択した行(またはノード)が変更されると、コンポーネントにより選択イベントが起動されます。このイベントにより、選択解除された行や選択された行が報告されます。コンポーネントにより選択が宣言的に処理される際、選択された行でロジックを実行する必要がある場合は、それらの行にアクセスしてロジックを実行するコードを実装する必要があります。これは、マネージドBeanの選択リスナー・メソッドで実行できます。詳細は、10.2.8項「表の選択された行でのアクションの実行について」を参照してください。
|
注意: 複数の選択を実行できるようにコンポーネントを構成した場合、ユーザーが行を1つ選択し、[Shift]キーを押して別の行を選択すると、間にあるすべての行が選択されます。この選択は、選択が複数のデータ・フェッチ・ブロックにまたがる場合でも保持されます。同様に、[Ctrl]キーを使用して、隣接していない行を選択することもできます。 たとえば、表が一度に25行のみフェッチするように構成されている場合に、ユーザーが100行選択すると、フレームワークにより選択が追跡されます。 |
表、ツリーまたはツリー表の実際のデータの表示に使用するコンポーネントを選択できます。たとえば、データを読取り専用にする場合は、データの表示にoutputTextコンポーネントを使用します。反対に、データを編集できるようにする場合にはinputTextコンポーネントを使用し、リストから選択する場合にはSelectOneコンポーネントを1つ使用します。これらのコンポーネントはすべて、列コンポーネントの子として配置されるか(表およびツリー表の場合)、nodeStampファセットに配置されます(ツリーの場合)。
値の編集が可能なコンポーネントを使用してデータを表示する場合、表、ツリーまたはツリー表で、すべての行を編集可能として一度に表示するか、現在アクティブな行以外をすべて読取り専用として表示するかを、editingMode属性を使用して選択できます。たとえば、図10-5に、行をすべて編集できる表を示します。ページは、ページに追加されたコンポーネント(inputText、inputDateおよびinputComboBoxListOfValuesコンポーネントなど)を使用してレンダリングされます。
図10-6に、同じ表(データの表示にinputText、inputDateおよびinputComboBoxListOfValuesコンポーネントを使用)を示しますが、アクティブな行のみに編集可能なコンポーネントを表示するように構成されています。ユーザーは、別の行をクリックして編集可能にできます(一度に編集可能にできるのは1つの行のみ)。ページを作成するために図10-5と同じ入力コンポーネントが使用されていても、編集されていない行のデータの表示に、outputTextコンポーネントが使用されていることに注意してください。これらのコンポーネントが実際にレンダリングされるのは、アクティブな行のみです。
現在アクティブな行は、表のactiveRowKey属性で決定されます。デフォルトでは、この属性の値は表で最初に表示される行です。表(またはツリーやツリー表)がリフレッシュされると、そのコンポーネントがスクロールされ、アクティブな行が表示されます(まだ表示されていない場合)。ユーザーが行をクリックしてその内容を編集すると、その行はアクティブな行になります。
編集できる行(またはノード)を1つのみにする場合、ユーザーがある行(またはノード)から次の行へ移動し、一度に1行のデータを送信(および検証)すると、表(またはツリーやツリー表)ではPPRが実行されます。すべての行を編集できるようにする場合、現在表示されている行またはノードを超えてスクロールするなど、PPRが実行されるイベントが発生するとデータが送信されます。
|
注意: 列には、編集可能なコンポーネントを複数使用しないでください。 |
編集可能なコンポーネントがすべて、クリックして編集するモードで表示されるわけではありません。たとえば、HTMLの入力要素を複数行表示するコンポーネントがこれに当たります。次のコンポーネントが含まれます。
SelectManyCheckbox
SelectManyListBox
SelectOneListBox
SelectOneRadio
SelectManyShuttle
|
パフォーマンスのヒント: レンダリングおよびポストバック中のパフォーマンスを向上させるには、表での編集を1行のみに構成する必要があります。 一度に編集できる行を1行のみにすると、出力コンポーネントでは生成されるHTMLが入力コンポーネントよりも少ないため、ページがより早く表示されます。また、読取り専用行に対してはクライアント・コンポーネントが作成されません。ユーザーがある行から次の行へ移動すると、表(またはツリーやツリー表)でPPRが実行されるため、その行のデータのみが送信され、その結果、すべてのセルの編集が可能で、表内のすべての行の全データが一度に送信される表よりパフォーマンスが高くなります。編集できる行を1行のみにすると、単一の行のデータのみが検証用に送信されるため、より直感的な検証も可能になり、その行のエラーのみが表示されます。 |
表、ツリーまたはツリー表は、ユーザーのアクションに基づいてポップアップ・ダイアログが表示されるように構成できます。たとえば、ユーザーがセルまたはノード上にマウスを置いた場合に、選択された行の一部のデータが表示されるようにポップアップ・ダイアログを構成できます。ユーザーが表やツリー表の行、またはツリーのノードを右クリックした場合のために、ポップアップ・メニューを作成することも可能です。また、表やツリー表では、ユーザーが特定の行ではなく、表の任意の場所を右クリックした場合のために、ポップアップ・メニューを作成できます。
すべての表、ツリーおよびツリー表には、contextMenuファセットが含まれます。ポップアップ・メニューをこのファセットに配置すると、ユーザーが行を右クリックした場合に、関連するメニューが表示されます。サーバーでポップアップ・メニューがフェッチされると、コンポーネントにより、ポップアップ・メニューが表示されている行に対しての現行性が自動的に確立されます。現行性の確立とは、表のモデルの現行行が、ポップアップ・メニューが表示されている行を指すことです。これを実現するには、表示されるたびにメニューをフェッチできるように、メニューが含まれるpopupコンポーネントのcontentDelivery属性がlazyUncachedに設定されている必要があります。
|
ヒント: 選択された行に基づいて、ポップアップ・メニューにコンテンツが動的に表示されるようにするには、ポップアップ・コンテンツの配信を
<af:tree value="#{fs.treeModel}"
contextMenuSelect="false" var="node" ..>
<f:facet name="contextMenu">
<af:popup id="myPopup" contentDelivery="lazyUncached">
<af:setPropertyListener from="#{fs.treeModel.rowData}"
to="#{dynamicContextMenuTable.currentTreeRowData}"
type="popupFetch" />
<af:menu>
<af:menu text="Node Info (Dynamic)">
<af:commandMenuItem actionListener=
"#{dynamicContextMenuTable.alertTreeRowData}"
text=
"Name - #{dynamicContextMenuTable.currentTreeRowData.name}" />
<af:commandMenuItem actionListener=
"#{dynamicContextMenuTable.alertTreeRowData}"
text=
"Path - #{dynamicContextMenuTable.currentTreeRowData.path}" />
<af:commandMenuItem actionListener=
"#{dynamicContextMenuTable.alertTreeRowData}"
text="Date -
#{dynamicContextMenuTable.currentTreeRowData.lastModified}" />
</af:menu>
</af:menu>
</af:popup>
</f:facet>
...
</af:tree>
バッキングBeanのコードは次のようになります。
public class DynamicContextMenuTableBean
{
...
public void setCurrentTreeRowData(Map currentTreeRowData)
{
_currentTreeRowData = currentTreeRowData;
}
public Map getCurrentTreeRowData()
{
return _currentTreeRowData;
}
private Map _currentTreeRowData;
}
|
表およびツリー表には、bodyContextMenuファセットが含まれます。メニューが含まれるポップアップをこのファセットに追加すると、ユーザーが特定の行ではなく、表をクリックした場合に表示されます。
ポップアップ・メニューの作成の詳細は、13.2項「ポップアップ要素の宣言的作成」を参照してください。
ADF Facesでは、表、ツリーまたはツリー表のコンテンツはサーバーでレンダリングされます。次のような場合には、クライアントがサーバー上のそのコンテンツにアクセスする必要があります。
クライアント側のアプリケーション・ロジックが、行固有のコンポーネントの状態を読み取る必要がある場合。たとえば、行の選択の変更に応じて、ページ内のその他のコンポーネント(通常はメニュー項目やツールバー・ボタン)の無効化や表示の状態をアプリケーションで更新する必要がある場合です。このロジックは、スタンプ設定されたinputHiddenコンポーネントを使用してクライアントに送信される、行固有のメタデータに依存している場合があります。これを有効化するために、アプリケーションでは、スタンプ設定されたコンポーネントから行固有の属性値を取得できる必要があります。
クライアント側のアプリケーション・ロジックが、行固有のコンポーネントの状態を変更する必要がある場合。たとえば、表の行にあるスタンプ設定されたコマンド・リンクをクリックすると、同じ行のその他のコンポーネントの状態が更新される場合です。
イベント処理動作を実装するために、ピアがコンポーネント・インスタンスにアクセスする必要がある場合(ピアの詳細は、3.1項「ADF Facesアーキテクチャの使用の概要」を参照してください)。たとえば、マウスのクリックに対応して、クライアント側のアクション・イベントを配信するには、AdfDhtmlCommandLinkPeerクラスが、イベント・ソースとして機能するコンポーネント・インスタンスを参照する必要があります。コンポーネントにも関連する状態が保持され、これには、disabledまたはpartialSubmitなど、イベント配信動作を制御する属性のみでなく、クライアント・リスナーも含まれます。
リッチ・クライアント・フレームワーク(RCF)では、クライアント側でELがサポートされないのみでなく、クライアントへの表モデル全体の送信もサポートされていないため、クライアント側のコードは、値にアクセスするようスタンプ設定されているコンポーネントに依存できません。各行で同じコンポーネント・インスタンスを再利用するかわりに、各行に新しいJavaScriptクライアント・コンポーネントが作成されます(どの行にもコンポーネントが1つ作成される必要があると仮定しています)。
そのため、クライアント上の行固有のデータにアクセスするには、それ自体がスタンプ設定されたコンポーネントを使用して値にアクセスする必要があります。クライアント側のデータ・モデルを使用せずにこれを実現するには、クライアント側の選択変更リスナーを使用します。詳細な手順は、10.10項「スタンプ設定を使用するコンポーネントからクライアント上の選択された値へのアクセス」を参照してください。
デフォルトでは、子を拡大するコンポーネント(panelStretchLayout内部のpanelCollectionコンポーネントなど)に表、ツリーおよびツリー表を配置すると、表、ツリーおよびツリー表が既存の領域全体に合せて拡大されます。ただし、列を表全体に拡大するには、columnStretching属性を使用して、特定の列が未使用の領域全体に拡大されるように指定する必要があります。そうしないと、表は行の数に応じて垂直に拡大されます。図10-7に示すように、列は拡大されません。
子を拡大しないコンポーネントに配置すると(たとえば、panelGroupLayout内部のpanelCollectionコンポーネントでverticalに設定など)、図10-8に示すように、デフォルトで表の幅が300pxに設定されます。
子を拡大しないコンポーネントに表を配置する場合、autoHeightRows属性を使用すると、指定した行数を超えないように表の高さを抑えることができます。この属性を正の整数に設定すると、表の高さは設定した行数で決定されます。この数値がfetchSize属性より大きいと、fetchSize属性の行数のみが返されます。autoHeightRowsを-1(デフォルト)に設定すると、自動サイズ設定を無効にできます。
自動サイズ設定が役立つのは、子を拡大するコンポーネントと拡大しないコンポーネントの両方で同じ表を使用する場合です。たとえば、12行が表示可能な6列の表があるとします。子を拡大するコンポーネントで使用する場合は、表を利用可能な領域全体に拡大します。その表を子を拡大しないコンポーネントで使用する場合は、表の高さを修正できるようにします。ただし、表の高さを設定すると、他のコンポーネントに配置した場合に、その表は拡大されません。この問題を解決するには、autoHeightRows表は行の数に応属性を設定します(拡大するコンポーネントでは無視され、拡大しないコンポーネントでは適用されます)。
表コンポーネントでは、CollectionModelクラスを使用して基礎となるコレクションのデータにアクセスします。このクラスは、JSF DataModelクラスを拡張し、行キーおよびソートのサポートを追加します。DataModelクラスでは、行は索引によって完全に識別されます。他のユーザーが行を追加したことにより、ある行を削除するユーザー・リクエストで異なる行が削除されてしまうなど、あるリクエストから次のリクエストまでに基礎となるデータが変更される場合、この識別方法が原因で問題が発生する可能性があります。これを回避するため、CollectionModelクラスは索引ではなく行キーに基づいています。
java.util.List、arrayおよびjavax.faces.model.DataModelなど、別のモデル・クラスも使用できます。これらのクラスのいずれかを使用する場合は、表コンポーネントにより、インスタンスがCollectionModelクラスに自動的に変換されますが、機能は追加されません。CollectionModelクラスの詳細は、http://myfaces.apache.org/trinidad/trinidad-1_2/trinidad-api/apidocs/index.htmlにあるMyFaces TrinidadのJavadocを参照してください。
|
注意: アプリケーションでFusionテクノロジ・スタックを使用する場合は、データ・コントロールを使用して表を作成でき、コレクション・モデルが作成されます。詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Webユーザー・インタフェース開発者ガイド』の「ADFによるデータバインドされた表の作成」の章を参照してください。 |
tableコンポーネントの直接的な子は、columnコンポーネントである必要があります。表示されるそれぞれの列コンポーネントは、表の個別の列として表示されます。列コンポーネントには、コンテンツやイメージの表示、またはその他の機能の提供に使用されるコンポーネントが含まれます。列コンポーネントで使用可能な機能の詳細は、10.2.1項「列および列データ」を参照してください。
各列の子コンポーネントは、その列の各行のデータを表示します。列では、子コンポーネントは行ごとには作成されませんが、表では各行のレンダリングにスタンプ設定機能が使用されます。各子には、行ごとに一度スタンプが設定され、これがすべての行に対して繰り返されます。各行にスタンプが設定されると、現在行のデータが、EL式を使用して特定可能なプロパティにコピーされます。このプロパティに使用する名前を、表のvarプロパティを使用して指定します。表のレンダリングが完了したら、このプロパティは削除されるか前の値に戻ります。
このスタンプ設定動作のため、一部のコンポーネントが列内で機能しない場合があります。入力および出力コンポーネントなど、大部分のコンポーネントは問題なく機能します。セル内に複数のコンポーネントを使用する必要がある場合は、それらをpanelGroupLayoutコンポーネントでラップします。表内の表など、それ自体がスタンプ機能をサポートしているコンポーネントはサポートされていません。実行時に値が動的に決定されるコンポーネントの使用方法の詳細は、10.2.9項「表の選択コンポーネント値の動的な決定について」を参照してください。
表にdetailStampファセットを使用して、オプションで表示または非表示にできるデータを指定できます。このファセットにコンポーネントを追加すると、表の各行に、展開および縮小するためのアイコンが付いた追加の列が表示されます。ユーザーがアイコンをクリックして開くと、図10-9に示すように、ファセットに追加されたコンポーネントが表示されます。
ユーザーが開かれた状態のアイコンをクリックして閉じると、図10-10に示すように、コンポーネントが非表示になります。
detailStampファセットの使用方法の詳細は、10.3項「表への非表示機能の追加」を参照してください。
列には、データの表示に使用されるコンポーネントが含まれます。前述したように、各項目の表示に必要な子コンポーネントは1つのみで、値は表のレンダリング時にスタンプ設定されます。列をソートすることも、列にフィルタ要素を含めることも可能です。ユーザーがフィルタに値を入力すると、フィルタに入力した値に一致するデータ・セットが戻されます。フィルタは、大文字と小文字を区別する、または大文字と小文字を区別しないように設定できます。これが許可されるように表が構成されている場合、ユーザーは列を並べ替えることもできます。列には、ヘッダー・ファセットとフッター・ファセットの両方があります。ヘッダー・ファセットは、列のヘッダー・テキスト属性のかわりに使用できるため、スタイル設定可能なコンポーネントを使用できます。フッター・ファセットは、列の下部に表示されます。たとえば、図10-11では、フッター・ファセットを使用して、2つの列の下部に合計が表示されています。戻された行数が表示可能な範囲を超えている場合、フッター・ファセットは表示されますが、ユーザーは最後の行までスクロールできます。
表コンポーネントには、ユーザーを支援する書式設定や視覚的な補助が多数用意されています。これらの機能を有効にし、どのように表示するかを指定できます。次にこれらの機能を示します。
行の選択: デフォルトでは、ユーザーは実行時に行を選択できません。ページのその他の場所または別のページにおいて、行でアクションを実行するために、ユーザーが行を選択できるようにするには、rowSelection属性を設定して、表で行の選択を有効化します。表は、単一の行または複数の行を選択できるように構成できます。選択された行でプログラムを使用してアクションを実行する方法の詳細は、10.2.8項「表の選択された行でのアクションの実行について」を参照してください。
表の高さ: 表の高さを絶対的(300ピクセルなど)に設定することも、autoHeightRows属性を使用して、一度に表示する行数に基づいて表の高さを決定することもできます。詳細は、10.1.6項「ジオメトリ管理および表、ツリーまたはツリー表コンポーネント」を参照してください。
|
注意: 表が |
グリッド線: デフォルトで、ADF表コンポーネントには、水平および垂直の両方のグリッド線が描画されます。これらは、horizontalGridVisibleおよびverticalGridVisible属性を使用して個別に無効化できます。
バンディング: columnBandingInterval属性を使用して、行または列のグループが異なる背景色で交互に表示されます。これは、隣り合う行または列のグループを区別する際に役立ちます。デフォルトでは、バンディングは無効化されています。
列グループ: 表の列は、列コンポーネントをネストさせることで、列グループにグループ化できます。各グループには、すべての列をリンクする独自の列グループ・ヘッダーを設定できます。
編集可能セル: 表へのデータの表示に入力テキスト・コンポーネントを使用する場合は、すべてのセルを編集できるように表を構成することも、ユーザーが明示的にセルをクリックして編集するように構成することもできます。詳細は、10.1.3項「表、ツリーおよびツリー表のデータの編集」を参照してください。
|
パフォーマンスのヒント: ユーザーがクリックした場合にのみセルの編集を可能にすると、表は最初はより早くロードされます。これは、表に大量のデータを表示する場合に便利です。 |
列の拡大: 列の幅すべてを合せても表全体に満たない場合は、columnStretching属性を設定し、領域を埋めるために列を拡大するかどうか、拡大する場合はどの列を拡大するかを決定できます。列の最小幅を設定できるため、表の列が多い場合に、拡大を有効にすると、列は設定した最小幅よりも小さくなります。拡大する列ごとに幅の割合を設定し、拡大時に列が占める領域の量を決定できます。
|
注意: 列の最小幅の合計がビューポートの表示可能な領域以上の場合、表はビューポートの外側まで拡大し、ビューポートの外側にアクセスできるようにスクロールバーが表示されます。 |
|
パフォーマンスのヒント: 列の拡大はデフォルトで無効化されています。この機能を有効化すると、複雑な表(データ量の多い表や、列がネストしている表など)に使用した場合には、クライアントのレンダリング時間のパフォーマンスに影響があります。 |
|
注意: ユーザーが表のスクロール可能なデータ本体にアクセスできなくなる可能性が高くなるため、行ヘッダーまたは固定されるように構成された列は拡大されません。 |
列の選択: ユーザーにデータの列の選択を許可できます。行の選択同様、単一の列または複数の列を選択できるように構成できます。columnSelectionListenerを使用して、新しい列がユーザーによって選択された際に起動されるColumnSelectionEventに応答することもできます。このイベントにより、選択解除された列や選択された列が報告されます。
列の並替え: ユーザーは、実行時に列ヘッダーをドラッグ・アンド・ドロップして列を並べ替えられます。デフォルトでは、列の並替えが許可されており、panelCollectionコンポーネントのメニュー項目で処理されます。詳細は、10.8項「表メニュー、ツールバーおよびステータス・バーの表示」を参照してください。
各列コンポーネントにも、ユーザーを支援する書式設定や視覚的な補助が多数用意されています。これらの機能を有効にし、どのように表示するかを指定できます。次にこれらの機能を示します。
列のソート: ユーザーが、指定された列を基準とし、sortable属性を使用して昇順または降順にコンテンツをソートできるよう列を構成できます。列ヘッダーの特別なインジケータにより、ユーザーは列がソート可能であることがわかります。
ユーザーがアイコンをクリックして、前にソートされていない列をソートすると、列のコンテンツは昇順でソートされます。次に同じヘッダーをクリックすると、コンテンツは降順でソートされます。表をソートできるようにするには、基礎となるデータ・モデルでもソートがサポートされている必要があります。詳細は、10.2.7項「プログラムを使用した表の列のソートの有効化について」を参照してください。
コンテンツの位置合せ: align属性を使用して、列内のコンテンツをstart、end、left、rightまたはcenterに位置合せできます。
|
ヒント: アプリケーションで複数の読み方向がサポートされている場合は、 |
列の幅: width属性を使用して、列の幅をピクセル単位の絶対値として指定できます。列が拡大できるように構成すると、幅をパーセントとして設定することもできます。
行折返し: noWrap属性を使用し、行を越えて列のコンテンツを折り返すかどうかを定義できます。デフォルトでは、コンテンツは折り返されません。
行ヘッダー: rowHeader属性を使用して、一番左の列を行ヘッダーに定義できます。その場合、一番左の列は列ヘッダーと同じ外観でレンダリングされますが、スクロールしてページから見えなくなることはありません。図10-12に、1列目が行ヘッダーとして構成されている場合に、表に部門がどのように表示されるかを示します。
行ヘッダー列の使用を選択し、行を選択できるように表を構成した場合、ユーザーが行の上にマウスを置くと、行ヘッダー列には図10-13に示すような選択矢印が表示されます。
複数選択が可能な表の場合、ユーザーがマウスを押して行ヘッダーでドラッグし、隣接する行のブロックを選択できます。また、ユーザーが上下にドラッグすると、表は垂直に自動スクロールされます。
|
パフォーマンスのヒント: 行ヘッダーを使用すると、表がさらに複雑になり、パフォーマンスに悪影響が発生する場合があります。 |
|
ヒント: 列の並替えや列幅の変更など、ユーザーは実行時に表が表示される方法を変更できますが、アプリケーションがユーザーのカスタマイズを許可するように構成されていないかぎり、ユーザーがページを終了するとそれらの値は保持されません。詳細は、第31章「JSFページでのユーザー・カスタマイズの許可」を参照してください。 |
「ADF Faces Tableの作成」ダイアログを使用して、JSFページに表を追加できます。このダイアログは、表に必要な各列へのcolumnコンポーネントの追加にも使用できます。また、EL式を使用して基礎となるモデルまたはBeanに表をバインドできます。
|
注意: アプリケーションでFusionテクノロジ・スタックを使用する場合は、データ・コントロールを使用して表を作成でき、バインディングが実行されます。詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Webユーザー・インタフェース開発者ガイド』の「ADFによるデータバインドされた表の作成」の章を参照してください。 |
ダイアログを完了して、表と列がページに追加されたら、プロパティ・インスペクタを使用して表または列の追加の属性を構成し、表イベントに対応するためにリスナーを追加できます。表のバインド先となるCollectionModelクラスを実装する必要があります。
ページに表を表示する手順:
コンポーネント・パレットの「共通コンポーネント」パネルから、「表」をドラッグ・アンド・ドロップし、「ADF Faces Tableの作成」ダイアログを開きます。
ダイアログを使用して、既存のモデルに表をバインドします。表が有効なモデルにバインドされると、作成される列がダイアログにより自動的に表示されます。ダイアログを使用して列のheaderおよびvalue属性の値を編集し、データの表示に使用されるコンポーネントのタイプを選択します。または、手動で列を構成し、後日バインドすることもできます。ダイアログの使用方法の詳細は、[F1]を押すか「ヘルプ」をクリックします。
プロパティ・インスペクタで、「共通」セクションを開きます。すでに表をモデルにバインドしてある場合は、value属性を設定します。このセクションを使用して、表固有の次の属性を設定できます。
rowSelection: 行を選択可能にする場合に値を設定します。有効な値はnone、single、multipleおよびmultipleNoSelectAllです。
|
注意:
|
選択された行でプログラムを使用してアクションを実行する方法の詳細は、10.2.8項「表の選択された行でのアクションの実行について」を参照してください。
columnSelection: 列を選択可能にする場合に値を設定します。有効な値はnone、singleおよびmultipleです。
「列」セクションを開きます。「ADF Faces Tableの作成」ダイアログを使用して表をバインドしてある場合、これらの設定を完了する必要があります。このセクションを使用して、表のバインドの変更、各行のデータへのアクセスに使用される変数名の変更、および各列に使用される表示ラベルやコンポーネントの変更を実行できます。
|
ヒント: リストされている以外のコンポーネントを使用する場合は、プロパティ・インスペクタで任意のコンポーネントを選択し、それを手動で変更します。
|
|
ヒント: 列に複数のコンポーネントを表示する場合は、その他のコンポーネントを手動で追加し、それらを
|
「外観」セクションを開きます。このセクションを使用し、次に示す表固有の属性を設定して、表の外観を設定します。
width: 表の幅を指定します。割合またはピクセル数で幅を指定できます。デフォルト設定は300ピクセルです。列を拡大するように表を構成する場合(columnStretching属性を使用)は、幅をパーセントに設定する必要があります。
|
ヒント: 表が、子を拡大するコンポーネントの子である場合、この幅の設定はオーバーライドされ、表はコンテナに合うように自動的に拡大されます。コンポーネントが拡大される方法の詳細は、8.2.1項「ジオメトリ管理およびコンポーネントの拡大」を参照してください。 |
columnStretching: 列の幅すべてを合せても表全体に満たない場合は、この属性を設定し、領域を埋めるために列を拡大するかどうか、拡大する場合はどの列を拡大するかも決定できます。
|
注意: 子を拡大するコンポーネントの中に表が配置されている場合、自動的に拡大されるのは表のみです。表に合うように列を拡大する場合、列の拡大は手動で構成する必要があります。 |
|
注意: ユーザーが表のスクロール可能なデータ本体にアクセスできなくなる可能性が高くなるため、行ヘッダーまたは固定されるように構成された列は拡大されません。 |
|
パフォーマンスのヒント: 列の拡大はデフォルトで無効化されています。この機能を有効化すると、クライアントにおける複雑な表のレンダリング時間のパフォーマンスに影響する場合があります。 |
列の拡大を次のいずれかの値に設定できます。
blank: 空の列を自動的に挿入して拡大する場合に使用します(表の幅全体が行の背景色になります)。
具体的な名前が付けられた列: 表に現在ある列を選択して拡大する列にできます。
last: 最後の列を、ウィンドウ内の使用されていない領域に合せて拡大する場合に使用します。
none: 何も拡大されないデフォルトのオプションです。パフォーマンスを最適化する場合に使用します。
multiple: パーセント値がwidth属性に設定されたすべての列は、その他の列がそれらの(拡大されない)幅にレンダリングされると、そのパーセントまで拡大されます。パーセント値は合計で重み付けされます。たとえば、3つの列のwidth属性を50%に設定すると、各列は、それ以外のすべての列がレンダリングされた後の残りの領域の1/3ずつになります。
|
ヒント: ユーザーは実行時に列幅の値を変更できますが、アプリケーションが変更の永続性を使用するように構成されていないかぎり、ユーザーがページを終了するとそれらの値は保持されません。変更の永続性の有効化および使用方法の詳細は、第31章「JSFページでのユーザー・カスタマイズの許可」を参照してください。 |
horizontalGridVisible: 水平のグリッド線を描画するかどうかを指定します。
verticalGridVisible: 垂直のグリッド線を描画するかどうかを指定します。
rowBandingInterval: 色のバンディングの目的で、連続する何行で行グループを形成するかを指定します。デフォルトでは、これは0に設定されており、すべての行が同じ背景色で表示されます。別の色を使用する場合は、これを1に設定します。
columnBandingInterval: 列のバンディングが行われる間隔を指定します。この値により、表の列バンディングの表示が制御されます。たとえば、columnBandingIntervalが1の場合、表内にバンディングされた列が交互に表示されます。
filterVisible: 入力されたフィルタ基準に一致する行のみが表示されるように、表にフィルタを追加できます。フィルタ処理を許可するように表を構成する場合、大文字と小文字を区別する、または大文字と小文字を区別しないようにフィルタを設定できます。詳細は、10.4項「表でのフィルタ処理の有効化」を参照してください。
テキスト属性: アクセシビリティを目的とした表のサマリーや説明だけでなく、行を表示できない場合に表示されるテキストを決定するテキスト文字列を定義できます。
「動作」セクションを開きます。このセクションを使用し、次に示す表固有の属性を設定して、表の動作を構成します。
disableColumnReordering: デフォルトでは、panelCollectionコンポーネントにデフォルトで含まれるメニュー・オプションを使用して、実行時に列を並べ替えられます。これは、ユーザーが列の順序を変更できないように変更できます。(panelCollectionコンポーネントには、表、ツリーおよびツリー表のデフォルトのメニューとツールバー・ボタンが用意されています。詳細は、10.8項「表メニュー、ツールバーおよびステータス・バーの表示」を参照してください。)
|
注意: ユーザーは列の順序を変更できますが、アプリケーションがユーザーのカスタマイズを許可するように構成されていないかぎり、ユーザーがページを終了するとそれらの値は保持されません。詳細は、第31章「JSFページでのユーザー・カスタマイズの許可」を参照してください。 |
FetchSize: 各データ・フェッチで戻されるブロックのサイズを設定します。デフォルトは25です。
|
ヒント: 表に合せるには何行必要であるかを判断するには、表の高さを取得して各行の高さで割ることで、 |
ContentDelivery: データを送信するタイミングを指定します。contentDelivery属性がimmediateに設定されている場合、コンポーネントのレンダリングと同時にデータがフェッチされます。contentDelivery属性がlazyに設定されている場合は、後続のリクエスト中にデータがフェッチされてクライアントに送信されます。属性がwhenAvailable(デフォルト)に設定されている場合は、データが利用可能かどうかレンダラでチェックされます。その場合は、コンテンツはすぐに配信されますそうでない場合は、遅延配信が使用されます。詳細は、10.1.1項「コンテンツの配信」を参照してください。
autoHeightRows: 使用可能な領域に合せて表で高さのサイズ設定が自動的に行われるようにする場合は、表に表示する最大の行数を指定します。デフォルト値は-1です(何行であっても自動サイズ設定は行われません)。値を0に設定して、fetchSizeと同じ値にすることもできます。
|
注意:
|
displayRow: 最初に表示される際に表に表示する行を指定します。使用可能な値は、表の上部に最初の行を表示する場合はfirst、表の下部に最後の行を表示する場合はlast(ユーザーが先行する行を表示するには上にスクロールする必要があります)、表で最初に選択された行を表示する場合はselectedです。
|
注意: この属性が正常に機能するには、表モデルの合計の行数が把握されている必要があります。 |
displayRowKey: 最初に表示される際に表に表示する行キーを指定します。値が文字列ではない場合があるため、属性は宣言的にではなくプログラムで設定する必要があります。この属性を指定すると、displayRow属性がオーバーライドされます。
|
注意: この属性が正常に機能するには、表モデルの合計の行数が把握されている必要があります。 |
editingMode: 編集可能なコンポーネントに、すべての行を編集可能にするか(editAll)、ユーザーが行をクリックした場合に編集可能にするか(clickToEdit)を指定します。詳細は、10.1.3項「表、ツリーおよびツリー表のデータの編集」を参照してください。
|
ヒント:
|
contextMenuSelect: ポップアップ・メニューを開くために右クリックする際に、行を選択するかどうかを指定します。trueに設定すると、行が選択されます。ポップアップ・メニューの詳細は、第13章「ポップアップ・ダイアログ、メニューおよびウィンドウの使用方法」を参照してください。
filterModel: filterVisibleとともに使用します。詳細は、10.4項「表でのフィルタ処理の有効化」を参照してください。
様々なリスナー: 表で対応するイベントが起動された場合に実行されるメソッドにリスナーをバインドします(columnSelectionListenerは「その他」セクションにあります)。詳細は、第5章「イベントの処理」を参照してください。
「その他」セクションを開き、次の設定を行います。
activeRowKey: clickToEditを選択すると、アクティブな行のみを編集できます。この行は、activeRowKey属性で決定されます。デフォルトでは、表が最初にレンダリングされると、アクティブな行が最初に表示可能な行になります。ユーザーが別の行をクリックすると、その行はアクティブな行になります。この動作は、activeRowKey属性に異なる値を設定することで変更できます。
columnResizing: エンド・ユーザーが実行時に列幅のサイズを変更できるようにするかどうかを指定します。無効に設定されている場合、列の幅はページのレンダリング後に1回設定され、ユーザーはそれらの幅を変更できなくなります。
|
ヒント: ユーザーは実行時に列幅の値を変更できますが、アプリケーションが変更の永続性を使用するように構成されていないかぎり、ユーザーがページを終了するとそれらの幅の値は保持されません。変更の永続性の有効化および使用方法の詳細は、第31章「JSFページでのユーザー・カスタマイズの許可」を参照してください。 |
構造ウィンドウで列を選択します。プロパティ・インスペクタで、「共通」セクションを開いて、列固有の次の属性を設定します。
headerText: 列のヘッダーに表示するテキストを指定します。outputTextコンポーネントを含むheaderファセットを追加する場合と等しい出力内容が生成されるため便利です。outputText以外のコンポーネントを使用する場合は、かわりに列のheaderファセットを使用する必要があります(詳細は手順12を参照してください)。headerファセットを追加すると、headerText属性の値は列ヘッダーにレンダリングされません。
align: この列の位置合せを指定します。左から右への表示では、左揃え、右揃え、中央揃えに、それぞれstart、endおよびcenterが使用されます。表示が左から右であるか右から左であるかに関係なく、左揃えまたは右揃えのセルが必要な場合には、値leftまたはrightを使用できます。デフォルト値はnullで、これはスキンに依存し、行のヘッダー列およびデータ列の対比で異なることを示します。スキンの詳細は、第20章「スタイルおよびスキンを使用した外観のカスタマイズ」を参照してください。
sortable: 列をソート可能にするかどうかを指定します。ソート可能な列には、クリックするとその列のプロパティで表がソートされるヘッダーがあります。列をソート可能にするには、sortable属性をtrueに設定し、この列のプロパティによるソートが、基礎となるモデルでサポートされている必要があることに注意してください。詳細は、10.2.7項「プログラムを使用した表の列のソートの有効化について」を参照してください。
|
注意: 列の選択が有効な場合は、列ヘッダーをクリックすると、列がソートされずに選択されます。この場合、昇順/降順のソート・インジケータをクリックすると、列をソートできます。 |
filterable: 列をフィルタ処理可能にするかどうかを指定します。フィルタ処理可能な列には、列ヘッダーの上部にフィルタ・フィールドが配置されます。列をフィルタ処理可能にするには、この属性をtrueに設定し、表にfilterModel属性を設定する必要があることに注意してください。リーフ列のみがフィルタ処理可能で、フィルタ・コンポーネントは、列ヘッダーが存在する場合にのみ表示されます。この列のsortProperty属性は、filterModelクラスのfilterProperty属性のキーとして使用する必要があります。
|
注意: フィルタ処理が有効化されている( |
「外観」セクションを開きます。このセクションを使用し、次に示す列固有の属性を使用して、列の外観を設定します。
displayIndex: 列の表示順序索引を指定します。列を並べ替えることが可能で、displayIndex属性に基づいて表に表示されます。displayIndex属性値が設定されていない列は、データ・ソースでの順序に基づいて最後に表示されます。親列の外にある子の列を並べ替えることはできないため、displayIndex属性はトップレベルの列にのみ適用されます。
width: 列の幅を指定します。
minimunWidth: 列幅の最低ピクセル数を指定します。ユーザーが列のサイズ変更を試行すると、この最小幅が強制されます。また、列がフレキシブルな場合にも、この最小幅より小さいサイズには縮小されません。ピクセル幅が定義されていて最小幅の方が大きい場合、最小幅は2つのうち小さい方の値になります。デフォルトで、最小幅は10ピクセルです。
showRequired: 対応する属性にデータが必要な場合に、列ヘッダーにアスタリスクを表示するかどうかを指定します。
headerNoWrapおよびnoWrap: コンテンツをヘッダーおよび列内で折り返すかどうかを指定します。
rowHeader: 列を表の行ヘッダーにする場合は、trueに設定します。
|
パフォーマンスのヒント: 行ヘッダーを使用すると、表がさらに複雑になり、パフォーマンスに悪影響が発生する場合があります。 |
「動作」セクションを開きます。このセクションを使用し、次に示す列固有の属性を使用して、列の動作を構成します。
sortProperty: この列によって表示されるプロパティを指定します。これは、フレームワークによって列のデータのソートに使用されるプロパティです。
frozen: スクロールする際に列がページから見えなくならないように、列を固定するかどうかを指定します。固定列までの表の列は、ヘッダーでロックされ、その他の列とともにスクロールされません。親を固定せずに子の列を単独で固定することはできないため、frozen属性はトップレベルの列にのみ適用されます。
|
パフォーマンスのヒント: 固定列を使用すると、表がさらに複雑になり、パフォーマンスに悪影響が発生する場合があります。 |
selected: trueに設定すると、最初のレンダリング時に列が選択されます。
既存の表に列を追加するには、構造ウィンドウで表を右クリックし、ポップアップ・メニューから「表の中に挿入」→「列」を選択します。
表にファセットを追加するには、表を右クリックして、ポップアップ・メニューからファセット - 表を選択し、追加するファセットのタイプを選択します。その後、ファセットに直接コンポーネントを追加できます。
|
ヒント: ファセットに使用できる直接の子は1つのみです。ファセットに複数のコンポーネントを表示する場合は、まずグループ・コンポーネント( |
列にファセットを追加するには、列を右クリックして、ポップアップ・メニューからファセット - 列を選択し、追加するファセットのタイプを選択します。その後、ファセットに直接コンポーネントを追加できます。
|
ヒント: ファセットに使用できる直接の子は1つのみです。ファセットに複数のコンポーネントを表示する場合は、まずグループ・コンポーネント( |
列にコンポーネントを子として追加し、データを表示します。
コンポーネントの値は、表のvar属性および表示する属性の変数値セットにバインドする必要があります。たとえば、File Explorerアプリケーションの表では、var属性の値としてfileが使用されており、1列目に各行のファイル名が表示されています。そのため、ディレクトリ名の表示に使用される出力コンポーネントの値は、#{file.name}です。
|
ヒント: 列の直接の子が入力コンポーネントの場合は、その幅を列幅に適切な幅に設定してください。幅が親列にとって広すぎる大きさに設定されていると、ブラウザにより、テキスト入力カーソルが必要以上に大きく拡大され、隣接する列を隠してしまう可能性があります。たとえば、 入力コンポーネントが列の直接の子ではない場合に、サイズが自動的に設定されるようにするには、 |
JDeveloperを使用してページに表を追加すると、JDeveloperにより、各属性の列のある表が作成されます。表をモデルにバインドすると、列にはモデルの属性が反映されます。まだモデルにバインドしていない場合は、JDeveloperにより、デフォルト値を使用して列が作成されます。表作成ダイアログでの作業中に、または後からプロパティ・インスペクタを使用して、デフォルト値を変更(列の追加/削除、列ヘッダーの変更など)できます。
例10-2に、File Explorerアプリケーション内の表の省略形のページ・コードを示します。
例10-2 File Explorerアプリケーション内のADF Facesの表
<af:table id="folderTable" var="file"
value="#{explorer.contentViewManager.
tableContentView.contentModel}"
binding="#{explorer.contentViewManager.
tableContentView.contentTable}"
emptyText="#{explorerBundle['global.no_row']}"
rowselection="multiple"
contextMenuId=":context1" contentDelivery="immediate"
columnStretching="last"
selectionListener="#{explorer.contentViewManager.
tableContentView.tableFileItem}"
summary="table data">
<af:column width="180" sortable="true" sortProperty="name"
headerText="" align="start">
<f:facet name="header">
<af:outputText value="#{explorerBundle['contents.name']}"/>
</f:facet>
<af:panelGroupLayout>
<af:image source="#{file.icon}"
inlineStyle="margin-right:3px; vertical-align:middle;"
shortDesc="file icon"/>
<af:outputText value="#{file.name}" noWrap="true"/>
</af:panelGroupLayout>
</af:column>
<af:column width="70" sortable="true"
sortProperty="property.size">
<f:facet name="header">
<af:outputText value="#{explorerBundle['contents.size']}"/>
</f:facet>
<af:outputText value="#{file.property.size}" noWrap="true"/>
</af:column>
...
<af:column width="100">
<f:facet name="header">
<af:outputText value="#{explorerBundle['global.properties']}"/>
</f:facet>
<af:commandLink text="#{explorerBundle['global.properties']}"
partialSubmit="true"
action="#{explorer.launchProperties}"
returnListener="#{explorer.returnFromProperties}"
windowWidth="300" windowHeight="300"
useWindow="true"></af:commandLink>
</af:column>
</af:table>
表を含むページがリクエストされ、コンテンツ配信がlazyに設定されている場合、ページでは最初は標準のライフサイクルが実行されます。ただし、そのリクエスト中にデータがフェッチされるのではなく、独立した特別なPPRリクエストが実行されます。ページのレンダリング直後であるため、レンダー・レスポンス・フェーズのみが実行され、対応するデータがフェッチおよび表示されます。ユーザーのアクションにより後続のデータ・フェッチが実行される場合(表のスクロールなど)、別のPPRリクエストが実行されます。図10-14に、2番目のPPRリクエスト中の表を含むページを示します。
ユーザーがソート可能な列のヘッダーをクリックすると、tableコンポーネントによりSortEventイベントが生成されます。このイベントにはgetSortCriteriaプロパティがあり、それを基にして表をソートする必要のある条件が返されます。表は、基礎となるCollectionModelインスタンスにsetSortCriteria()メソッドをコールしてこのイベントに対応し、登録済の任意のSortListenerインスタンスをコールします。
表の列のソートを有効にできるのは、基礎となるモデルでソートがサポートされている場合のみです。モデルがCollectionModelインスタンスの場合は、次のメソッドを実装する必要があります。
public boolean isSortable(String propertyName)public List getSortCriteria()public void setSortCriteria(List criteria)詳細は、http://myfaces.apache.org/trinidad/trinidad-1_2/trinidad-api/apidocs/index.htmlにあるMyFaces TrinidadのJavadocを参照してください。
基礎となるモデルがCollectionModelインスタンスではない場合、tableコンポーネントにより、どのプロパティがソート可能かを判断するために実際のデータが自動的に調査されます。java.lang.Comparableクラスを実装するデータがある列はソート可能です。この自動サポートは、CollectionModelに直接ソートをコーディングする(ソートをSQLのORDER BY句に変換するなど)ほど効率はよくありませんが、小規模なデータ・セットには十分です。
|
注意: 自動サポートでは、1つの列のみのソートが提供されます。複数列のソートはサポートされていません。 |
ユーザーは表の1行以上を選択し、それらの行に対してアクションを実行できます。
表の選択状態が変更されると、表により選択イベントが起動されます。selectionEventイベントは、選択解除された行と選択された行をレポートします。
表の選択イベントをリスニングするには、selectionListener属性を使用するか、addselectionListener()メソッドを使用して表にリスナーを追加して、表にリスナーを登録します。これにより、リスナーは選択された行にアクセスし、それらの行に対してアクションを実行できます。
現在の選択内容(選択された1行または複数の行)はRowKeySetオブジェクトで、表に対してgetSelectedRowKeys()メソッドをコールして取得できます。プログラムを使用して選択内容を変更するには、次のいずれかを実行します。
RowKeySetオブジェクトにrowKeyオブジェクトを追加するか、RowKeySetオブジェクトから削除します。
表に対してsetRowIndex()またはsetRowKey()メソッドをコールして、特定の行を現在行にします。その後、RowKeySetオブジェクトに対してadd()またはremove()メソッドをコールして、その行を選択内容に追加するか、選択内容から削除できます。
例10-3に表の一部を示します(この部分では、ユーザーが複数の行を選択し、「削除」ボタンをクリックしてそれらの行を削除できます)。アクション・リスナーは、mybeanマネージドBeanのperformDeleteメソッドにバインドされます。
例10-3 行の選択
<af:table binding="#{mybean.table}" rowselection="multiple" ...>
...
</af:table>
<af:commandButton text="Delete" actionListener="#{mybean.performDelete}"/>
例10-4に、選択されたすべての行を反復し、それぞれにmarkForDeletionメソッドをコールするアクション・メソッドperformDeleteを示します。
例10-4 rowKeyオブジェクトの使用
public void performDelete(ActionEvent action)
{
UIXTable table = getTable();
Iterator selection = table.getSelectedRowKeys().iterator();
Object oldKey = table.getRowKey();
while(selection.hasNext())
{
Object rowKey = selection.next();
table.setRowKey(rowKey);
MyRowImpl row = (MyRowImpl) table.getRowData();
//custom method exposed on an implementation of Row interface.
row.markForDeletion();
}
// restore the old key:
table.setRowKey(oldKey);
}
// Binding methods for access to the table.
public void setTable(UIXTable table) { _table = table; }
public UIXTable getTable() { return _table; }
private UIXTable _table;
表にselectOneコンポーネントを使用する場合がありますが、各行でコンポーネントに異なる選択内容が表示される必要があります。そのため、実行時に項目のリストを動的に決定する必要があります。
個々の項目にスタンプを設定するにはforEachコンポーネントを使用する必要があると考える可能性がありますが、forEachはCollectionModelインスタンスと連携しないため機能しません。また、表で使用されるようなコンポーネント管理のEL変数を使用するEL式にはバインドできません。forEachコンポーネントはJSFタグの実行ステップで関数を実行しますが、表では次に示すコンポーネントのエンコーディング・ステップで実行します。そのため、forEachコンポーネントは表の準備ができる前に実行され、反復関数は実行されません。
selectOneコンポーネントの場合、直接の子はitemsコンポーネントであることが必要です。itemsコンポーネントは行変数(<f:items value="#{row.Items}"/>など)に直接バインドできますが、こうすると、基礎となるモデルを変更できなくなります。
かわりに、例10-5に示すように、項目のリストを作成するマネージドBeanを作成します。
例10-5 項目のリストを戻すマネージドBean
public List<SelectItem> getItems()
{
// Grab the list of items
FacesContext context = FacesContext.getCurrentInstance();
Object rowItemObj = context.getApplication().evaluateExpressionGet(
context, "#{row.items}", Object.class);
if (rowItemObj == null)
return null;
// Convert the model objects into items
List<SomeModelObject> list = (List<SomeModelObject>) rowItemObj;
List<SelectItem> items = new ArrayList<SelectItem>(list.size());
for (SomeModelObject entry : list)
{
items.add(new SelectItem(entry.getValue(), entry.getLabel());public
}
// Return the items
return items;
}
例10-6に示すように、ページの1つのコンポーネントからリストにアクセスできます。
表は使用しないが、同じスタンプ設定機能が必要な場合には、イテレータ・タグを使用できます。たとえば、定期的な表要素のリストを表示し、各要素に対して名前、アトミック番号、記号およびグループを表示するとします。例10-7に示すように、イテレータ・タグを使用できます。
例10-7 イテレータ・タグの使用
<af:iterator var="row" first="3" rows="3" varStatus="stat"
value="#{periodicTable.tableData}" >
<af:outputText value="#{stat.count}.Index:#{stat.index} of
#{stat.model.rowCount}"/>
<af:inputText label="Element Name" value="#{row.name}"/>
<af:inputText label="Atomic Number" value="#{row.number}"/>
<af:inputText label="Symbol" value="#{row.symbol}"/>
<af:inputText label="Group" value="#{row.group}"/>
</af:iterator>
各子には、必要に応じて何度でもスタンプ設定できます。反復は、first属性で指定された索引から開始され、row属性で指定された索引まで行われます。row属性が0に設定されている場合、反復は基礎となるデータにそれ以上要素がなくなるまで続けられます。
表にdetailStampファセットを使用して、表示または非表示にできるデータを指定できます。このファセットにコンポーネントを追加すると、表に、切替えアイコンが付いた追加の列が表示されます。ユーザーがアイコンをクリックすると、ファセットに追加されたコンポーネントが表示されます。ユーザーが再度切替えアイコンをクリックすると、コンポーネントが非表示になります。図10-15に、コンテンツがdetailStampファセットに追加された際に表示される追加の列を示します。
|
注意:
|
図10-16に、1行目のdetailStampファセットが表示されている同じ表を示します。
|
注意: 列を固定できるように表を設定している場合、 |
detailStampファセットを使用するには、表示または非表示にするデータにバインドされているコンポーネントをファセットに挿入します。
detailStampファセットを使用する手順:
コンポーネント・パレットで、ファセットに表示するコンポーネントをdetailStampファセット・フォルダにドラッグします。図10-17に、構造ウィンドウのdetailStampファセット・フォルダを示します。
|
ヒント: 構造ウィンドウにファセット・フォルダが表示されない場合は、表を右クリックしてファセット - 表→詳細スタンプを選択します。 |
表示する属性が現在のレコードに固有の場合は、現在のレコードのデータの表示に表の変数が使用されるように、(単純にコンポーネントが属性にバインドされる)JSFコードを置き換えます。
例10-8に、選択した行の詳細が表示されている図10-16に示されているdetailStampファセットの表示に使用された省略形のコードを示します。
例10-8 detailStampファセットのコード
<af:table rowSelection="multiple" var="test1" value="#{tableTestData}" <f:facet name="detailStamp"> <af:panelFormLayout rows="4" labelWidth="33%" fieldWidth="67%" inlineStyle="width:400px"> <af:inputText label="Name" value="#{test1.name}"/> <af:group> <af:inputText label="Size" value="#{test1.size}"/> <af:inputText label="Date Modified" value="#{test1.inputDate}"/> <af:inputText label="Created by"/> </af:group> </af:panelFormLayout> </f:facet> </af:table>
|
注意: アプリケーションでFusionテクノロジ・スタックを使用する場合は、データ・コントロールから |
値がフィルタに一致する行のみを表に表示するために使用できるフィルタを表に追加できます。有効化されて、表示に設定されている場合、検索可能な各列の上に検索条件入力フィールドが表示されます。
たとえば、図10-18の表は、Location値が1700の行のみを表示するようにフィルタ処理されています。
フィルタ処理された表の検索はQuery-by-Exampleに基づいており、QBEテキストまたは日付入力フィールド書式を使用します。検索基準の変更では>および<=などの演算子の文字を入力できるようにするため、入力バリデータは無効になっています。たとえば、数値列の検索条件として>1500を入力できます。ワイルドカード文字もサポートされています。検索は、大文字と小文字を区別する、または大文字と小文字を区別しないようにできます。列でQBEがサポートされていない場合、検索条件入力フィールドはその列にレンダリングされません。
フィルタ処理機能では、データを表にフィルタ処理するためのモデルが使用されます。表のfilterModel属性オブジェクトは、FilterableQueryDescriptorクラスのインスタンスにバインドする必要があります。
|
注意: アプリケーションでFusionテクノロジ・スタックを使用する場合は、データ・コントロールを使用して表を作成でき、フィルタ処理が作成されます。詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Webユーザー・インタフェース開発者ガイド』の「ADFによるデータバインドされた表の作成」の章を参照してください。 |
例10-9では、フィルタ入力フィールドを有効にするために表のfilterVisible属性がtrueに設定されていて、filterModelインスタンスの列を識別するために列にsortProperty属性が設定されています。各列要素では、filterable属性がtrueに設定されています。
例10-9 フィルタ処理が有効にされている表コンポーネント
<af:table value="#{myBean.products}" var="row"
...
filterVisible="true"
...
rowselection="single">
...
<af:column sortProperty="ProductID" filterable="true" sortable="true"
<af:outputText value="#{row.ProductID}">
...
</af:column>
<af:column sortProperty="Name" filterable="true" sortable="true"
<af:outputText value="#{row.Name}"/>
...
</af:column>
<af:column sortProperty="warehouse" filterable="true" sortable="true"
<af:outputText value="#{row.warehouse}"/>
...
</af:column>
</af:table>
表にフィルタ処理機能を追加するには、まずフィルタ処理機能を提供するクラスを作成します。次に表をそのクラスにバインドし、フィルタ処理機能を使用するよう表と列を構成します。フィルタ処理機能を使用する表では、headerText属性に値が設定されているか、フィルタ処理される列のheaderファセットにコンポーネントが含まれている必要があります。これにより、フィルタ・コンポーネントが表示されます。また、filterModelクラスではsortProperty属性が使用されるため、列もソート可能に構成されている必要があります。
表にフィルタ処理機能を追加する手順:
FilterableQueryDescriptorクラスのサブクラスであるJavaクラスを作成します。このクラスの詳細は、ADF FacesのJavadocを参照してください。
10.2項「表へのデータの表示」で説明されているように、表を作成します。
構造ウィンドウで表を選択し、プロパティ・インスペクタで次の属性を設定します。
filterVisible: 検索可能な列の上にフィルタ条件入力フィールドを表示する場合はtrueに設定します。
filterModel: 手順1で作成したFilterableQueryDescriptorクラスのインスタンスにバインドします。
|
ヒント: フィルタに
|
構造ウィンドウで表の列を選択し、プロパティ・インスペクタで表の各列に対して次の設定を行います。
filterable: trueに設定します。
filterFeatures: caseSensitiveまたはcaseInsensitiveに設定します。指定されない場合、大文字と小文字の区別はモデルによって決定されます。
ADF Facesのツリー・コンポーネントは、組織図や階層ディレクトリ構造などの階層データを表示します。これらのタイプのデータには、一連のトップレベル・ノードがあり、構造の各要素では、展開してその他の要素を格納できます。たとえば、組織図で、階層の各要素であるそれぞれの従業員には、任意の数の子要素(直属の部下)を含むことができます。ツリー・コンポーネントでは、複数のルート要素がサポートされています。これには、構造を表す形式でデータが表示され、各要素は階層内のレベルを表すために適切なレベルにインデントされ、親に接続されています。ユーザーは階層の一部を展開および縮小できます。図10-19に、File Explorerアプリケーションのディレクトリの表示に使用されるツリーを示します。
ADF Facesのツリー・コンポーネントでは、基礎となる階層のデータにアクセスするためのモデルを使用します。特定のモデル・クラスはoracle.adf.view.rich.model.TreeModelで、10.2項「表へのデータの表示」で説明されているように、CollectionModelを拡張します。
ツリーをサポートする独自のツリー・モデルを作成する必要があります。ツリー・モデルは行のコレクションです。現在行に子の行が含まれている場合にtrueを返すisContainer()メソッドがあります。現在行の子にアクセスするには、enterContainer()メソッドをコールします。このメソッドをコールすると、TreeModelインスタンスが子の行のコレクションに変わります。親のコレクションに戻すには、exitContainer()メソッドをコールします。
例10-10に示すように、TreeModelクラスの作成時には、oracle.adf.view.rich.model.ChildPropertyTreeModelクラスが便利です。
例10-10 TreeModelの作成
List<TreeNode> root = new ArrayList<TreeNode>();
for(int i = 0; i < firstLevelSize; i++)
{
List<TreeNode> level1 = new ArrayList<TreeNode>();
for(int j = 0; j < i; j++)
{
List<TreeNode> level2 = new ArrayList<TreeNode>();
for(int k=0; k<j; k++)
{
TreeNode z = new TreeNode(null, _nodeVal(i,j,k));
level2.add(z);
}
TreeNode c = new TreeNode(level2, _nodeVal(i,j));
level1.add(c);
}
TreeNode n = new TreeNode(level1, _nodeVal(i));
root.add(n);
}
ChildPropertyTreeModel model = new ChildPropertyTreeModel(root, "children");
private String _nodeVal(Integer... args)
{
StringBuilder s = new StringBuilder();
for(Integer i : args)
s.append(i);
return s.toString();
}
|
注意: アプリケーションでFusionテクノロジ・スタックを使用する場合は、データ・コントロールを使用してツリーを作成でき、モデルが作成されます。詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Webユーザー・インタフェース開発者ガイド』の「マスター/ディテール・データの表示」の章を参照してください。 |
ツリーは、表の操作と同じような方法で操作できます。次の操作を実行できます。
ノードを現在のノードにするには、リストへの適切な索引を使用して、ツリーでsetRowIndex()メソッドをコールします。または、適切なrowKeyオブジェクトを使用してsetRowKey()メソッドをコールします。
特定のノードにアクセスするには、まずそのノードを現在のノードにしてから、ツリーでgetRowData()メソッドをコールします。
展開または縮小されているノードの行にアクセスするには、RowDisclosureEventでgetAddedSetメソッドおよびgetRemovedSetメソッドをコールします。詳細は、10.5.4項「プログラムを使用したノードの開閉について」を参照してください。
ノードの子コレクションを操作するには、setRowIndex()およびsetRowKey()メソッドをコールする前にenterContainer()メソッドをコールします。その後、exitContainer()メソッドをコールして親ノードに戻します。
ツリー(任意のレベル)内のノードのrowKeyを指すには、focusRowKey属性を使用します。focusRowKey属性は、ユーザーがノードを右クリックして、「先頭として表示」ポップアップ・メニュー項目(またはpanelCollectionコンポーネントの「先頭として表示」ツールバー・ボタン)を選択すると設定されます。
focusRowKey属性が設定されていると、focusRowKey属性で指定されたノードがツリーのルート・ノードとしてツリーにレンダリングされ、ルート・ノードの横に「階層セレクタ」アイコンが表示されます。「階層セレクタ」アイコンをクリックすると、ツリーのルート・ノードからfocusRowKeyへのパスを示す「階層セレクタ」ダイアログが表示されます。これがどのように表示されるかは、pathStampファセットへのコンポーネントの配置によって決まります。
表と同様、ツリーでも、個々のノードのコンテンツを表示するためにスタンプ設定機能が使用されます。ツリーには、各ノードのデータの表示に使用されるコンポーネントのホルダーであるnodeStampファセットが含まれます。各ノードが一度ずつ、すべてのノードで繰り返しレンダリング(スタンプ設定)されます。各ノードにスタンプが設定されると、現在のノードのデータが、EL式を使用して特定可能なプロパティにコピーされます。このプロパティに使用する名前を、ツリーのvarプロパティを使用して指定します。ツリーのレンダリングが完了したら、このプロパティは削除されるか前の値に戻ります。
このスタンプ設定動作のため、ADF Facesツリーで子としてサポートされるのは、特定タイプのコンポーネントのみです。動作が設定されていないすべてのコンポーネントは、大部分がValueHolderまたはActionSourceインタフェースを実装するコンポーネントとしてサポートされています。
例10-11では、ツリーに表示されるデータを識別する変数nodeを使用して各要素のデータを参照しています。nodeStampファセットは、node変数からさらにプロパティを取得して、各要素のデータを表示します。
例10-11 ツリーへのデータの表示
<af:tree var="node">
<f:facet name="nodeStamp">
<af:outputText value="#{node.firstname}"/>
</f:facet>
</af:tree>
ツリーにもpathStampファセットが含まれます。このファセットは、nodeStampファセットがツリーのコンテンツのレンダリング方法を決定するのと同じように、「階層セレクタ」ダイアログのコンテンツのレンダリング方法を決定します。pathStampファセット内部のコンポーネントは、単純なoutputText、imageおよびoutputFormattedタグの組合せにできますが、「階層セレクタ」ポップアップではユーザー入力は許可されていないため、入力コンポーネント(任意のEditableValueHolderコンポーネント)にすることはできません。このファセットが指定されていない場合、「階層セレクタ」アイコンはレンダリングされません。
たとえば、pathStampファセットにイメージおよびoutputTextコンポーネントを含めると、ツリーにより、「階層セレクタ」ダイアログの各ノード・レベルにイメージとoutputTextコンポーネントがレンダリングされます。値へのアクセスには同じEL式を使用します。たとえば、outputTextコンポーネントのパスの各ノードに名前を表示する場合、EL式は<af:outputText value="#{node.firstname}"/>になります。
|
ヒント:
|
ツリーを作成するには、ページにツリー・コンポーネントを追加し、表示および動作プロパティを構成します。
ページにツリーを追加する手順:
例10-10に示すように、org.apache.myfaces.trinidad.model.TreeModelクラスを拡張するJavaクラスを作成します。
コンポーネント・パレットの「共通コンポーネント」パネルから、「ツリー」をドラッグ・アンド・ドロップし、「ツリーの挿入」ダイアログを開きます。必要に応じてツリーを構成します。ダイアログの使用方法のヘルプを参照するには、「ヘルプ」をクリックするか、[F1]を押します。
プロパティ・インスペクタで、「データ」セクションを開いて次の属性を設定します。
value: ツリーをバインドするオブジェクトのEL式を指定します。手順1で作成したように、org.apache.myfaces.trinidad.model.TreeModelのインスタンスであることが必要です。
var: 各ノードを表す変数名を指定します。
varStatus: オプションで、コンポーネントの状態の判断に使用可能な変数を入力します。レンダー・レスポンス・フェーズ中に、ツリーによりモデル行が反復され、各ノードがレンダリングされます。指定された任意のノードに対して、varStatus属性で次の情報を指定します。
model: CollectionModelインスタンスへの参照
index: 現在行の索引
rowKey: 現在のノードの一意キー
「外観」セクションを開き、次の属性を設定します。
displayRow: 最初に表示される際にツリーに表示するノードを指定します。使用可能な値は、最初のノードを表示する場合はfirst、最後のノードを表示する場合はlast、ツリーの最初に選択されたノードを表示する場合はselectedです。デフォルトは、firstです。
displayRowKey: 最初に表示される際にツリーに表示する行キーを指定します。この属性はプログラムのみを使用して設定する必要があります。この属性を指定すると、displayRow属性がオーバーライドされます。
summary: オプションで、ツリーによって表示されるデータのサマリーを入力します。
「動作」セクションを開き、次の属性を設定します。
initiallyExpanded: コンポーネントが初めてレンダリングされる際に、すべてのノードを開いておく場合はtrueに設定します。
editingMode: ツリーへのデータの表示に使用された編集可能なコンポーネントで、すべてのノードを編集可能にするか(editAll)、ユーザーがノードをクリックした場合に編集可能にするか(clickToEdit)を指定します。詳細は、10.1.3項「表、ツリーおよびツリー表のデータの編集」を参照してください。
contextMenuSelect: 右クリックしてポップアップ・メニューを開く際に、ノードを選択するかどうかを決定します。trueに設定すると、ノードが選択されます。ポップアップ・メニューの詳細は、第13章「ポップアップ・ダイアログ、メニューおよびウィンドウの使用方法」を参照してください。
rowSelection: ノードを選択可能にする場合に値を設定します。有効な値はnone、singleまたはmultipleです。選択されたノードでプログラムを使用してアクションを実行する方法の詳細は、10.5.5項「プログラムを使用したノードの選択について」を参照してください。
ContentDelivery: データを送信するタイミングを指定します。contentDelivery属性がimmediateに設定されている場合、コンポーネントのレンダリングと同時にデータがフェッチされます。contentDelivery属性がlazyに設定されている場合は、後続のリクエスト中にデータがフェッチされてクライアントに送信されます。属性がwhenAvailable(デフォルト)に設定されている場合は、データが利用可能かどうかレンダラでチェックされます。その場合は、コンテンツはすぐに配信されますそうでない場合は、遅延配信が使用されます。詳細は、10.1.1項「コンテンツの配信」を参照してください。
fetchSize: データ・フェッチ・ブロックの行数を指定します。詳細は、10.1.1項「コンテンツの配信」を参照してください。
selectionListener: オプションで、選択イベントを処理するリスナーにEL式を入力します。詳細は、10.5.5項「プログラムを使用したノードの選択について」を参照してください。
focusListener: オプションで、フォーカス・イベントを処理するリスナーにEL式を入力します。
rowDisclosureListener: オプションで、ノードの表示イベントを処理するリスナー・メソッドにEL式を入力します。
「拡張」セクションを開き、次の属性を設定します。
focusRowKey: オプションで、最初にフォーカスされるノードを入力します。
disclosedRowKeys: オプションで、ノードの表示を処理するバッキングBeanのメソッドにEL式を入力します。詳細は、10.5.4項「プログラムを使用したノードの開閉について」を参照してください。
selectedRowKeys: オプションで、最初に選択されるノードのキーを入力します。詳細は、10.5.5項「プログラムを使用したノードの選択について」を参照してください。
ツリーの高さのサイズを自動的に設定する場合は、「その他」セクションを開き、AutoHeightRowsをノードの最大値に設定して、スクロール・バーが表示される前に表示します。デフォルト値は-1です(どのような数値であっても自動サイズ設定は行われません)。値を0に設定して、fetchSizeと同じ値にできます。
|
注意:
|
コンポーネントを追加してツリーにデータを表示するには、コンポーネント・パレットからnodeStampファセットに必要なコンポーネントをドラッグします。図10-20に、File Explorerアプリケーションのディレクトリの表示に使用されたツリーのnodeStampファセットを示します。
コンポーネントの値は、ツリーのvar属性および表示する属性の変数値セットにバインドする必要があります。たとえば、File Explorerアプリケーションのツリーでは、var属性の値としてfolderが使用されており、各ノードのディレクトリ名が表示されています。そのため、ディレクトリ名の表示に使用される出力コンポーネントの値は、#{folder.name}です。
|
ヒント: ファセットに使用できる子コンポーネントは1つのみです。そのため、ノードごとに複数のコンポーネントを使用する場合は、図10-20に示すように、ファセットの直接の子にできるグループ・コンポーネント内にコンポーネントを配置します。 |
ページにツリーを追加すると、JDeveloperによりnodeStampファセットが追加され、ツリーのノードにスタンプが設定されます。例10-12に、File Explorerアプリケーション内のディレクトリ構造を表示するツリーの省略形のコードを示します。
例10-12 JSPページ内のADF Facesツリーのコード
<af:tree id="folderTree"
var="folder"
binding="#{explorer.navigatorManager.foldersNavigator
.foldersTreeComponent}"
value="#{explorer.navigatorManager.foldersNavigator.
foldersTreeModel}"
disclosedRowKeys="#{explorer.navigatorManager.foldersNavigator.
foldersTreeDisclosedRowKeys}"
rowSelection="single"
contextMenuId=":context2"
selectionListener="#{explorer.navigatorManager.foldersNavigator.
showSelectedFolderContent}">
<f:facet name="nodeStamp">
<af:panelGroupLayout>
<af:image id="folderNodeStampImg" source="#{folder.icon}"
inlineStyle="vertical-align:middle; margin-right:3px;
shortDesc="folder icon"/>
<af:outputText id="folderNodeStampText" value="#{folder.name}"/>
</af:panelGroupLayout>
</f:facet>
</af:tree>
ツリーは、階層でのレベルを示すためにノードがインデントされている形式で表示されます。ユーザーはクリックしてノードを開き、子ノードを表示できます。ユーザーは開いた状態のノードをクリックして閉じることもできます。ユーザーがこれらのアイコンのいずれかをクリックすると、コンポーネントによりRowDisclosureEventイベントが生成されます。このイベントに対応する処理を実行するには、カスタムのrowDisclosureListenerメソッドを登録します。詳細は、10.5.4項「プログラムを使用したノードの開閉について」を参照してください。
ユーザーがノードを選択または選択解除すると、ツリー・コンポーネントによりselectionEventイベントが起動されます。選択されたノードに基づいてツリー・コンポーネントで後処理を実行するカスタムのselectionListenerインスタンスを登録できます。詳細は、10.5.5項「プログラムを使用したノードの選択について」を参照してください。
RowDisclosureEventイベントには、閉じた状態のすべてのノード用のRemovedSetオブジェクトと、開いた状態のすべてのノード用のAddedSetオブジェクトの2つのRowKeySetオブジェクトがあります。コンポーネントは、追加されたセットの全ノードの下位のサブツリーを開き、削除されたセットの全ノードの下位のサブツリーを閉じます。
例10-13に示すように、カスタムのrowDisclosureListenerメソッドは、ツリー・コンポーネントで後処理を実行できます。
例10-13 rowDisclosureListenerを含むツリー表コンポーネント
<af:treeTable id="folderTree" var="directory" value="#{fs.treeModel}"
binding="#{editor.component}" rowselection="multiple"
columnselection="multiple" focusRowKey="#{fs.defaultFocusRowKey}"
selectionListener="#{fs.Table}"
contextMenuId="treeTableMenu"
rowDisclosureListener="#{fs.handleRowDisclosure}">
例10-14に、行公開イベントを処理するバッキングBeanメソッドを示します。例は、ツリー・ノードの展開を示しています。ツリー・ノードを縮小する場合は、getRemovedSetを使用します。
例10-14 rowDisclosureEvent用バッキングBeanメソッド
public void handleRowDisclosure(RowDisclosureEvent rowDisclosureEvent)
throws Exception {
Object rowKey = null;
Object rowData = null;
RichTree tree = (RichTree) rowDisclosureEvent.getSource();
RowKeySet rks = rowDisclosureEvent.getAddedSet();
if (rks != null) {
int setSize = rks.size();
if (setSize > 1) {
throw new Exception("Unexpected multiple row disclosure
added row sets found.");
}
if (setSize == 0) {
// nothing in getAddedSet indicates this is a node
// contraction, not expansion. If interested only in handling
// node expansion at this point, return.
return;
}
rowKey = rks.iterator().next();
tree.setRowKey(rowKey);
rowData = tree.getRowData();
// Do whatever is necessary for accessing tree node from
// rowData, by casting it to an appropriate data structure
// for example, a Java map or Java bean, and so forth.
}
}
ツリーおよびツリー表では、oracle.adf.view.rich.model.RowKeySetクラスのインスタンスを使用して、どのノードが開かれているかを追跡します。このインスタンスは、コンポーネントのdisclosedRowKeys属性として格納されます。例10-15に示すように、このインスタンスを使用して、階層内のノードの開いた状態または閉じた状態をプログラムで制御できます。RowKeySetインスタンスに含まれるノードは開かれ、その他すべてのノードは閉じられます。addAll()メソッドによりすべての要素がセットに追加され、removeAll()メソッドによりすべてのノードがセットから削除されます。
例10-15 disclosedRowKeys属性を含むツリー・コンポーネント
<af:tree var="node"
inlineStyle="width:90%; height:300px"
id="displayRowTable"
varStatus="vs"
rowselection="single"
disclosedRowKeys="#{treeTableTestData.disclosedRowKeys}"
value="#{treeTableTestData.treeModel}">
例10-16に、公開された行キーを処理するバッキングBeanメソッドを示します。
例10-16 行キーを処理するためのバッキングBeanメソッド
public RowKeySet getDisclosedRowKeys()
{
if (disclosedRowKeys == null)
{
// Create the PathSet that we will use to store the initial
// expansion state for the tree
RowKeySet treeState = new RowKeySetTreeImpl();
// RowKeySet requires access to the TreeModel for currency.
TreeModel model = getTreeModel();
treeState.setCollectionModel(model);
// Make the model point at the root node
int oldIndex = model.getRowIndex();
model.setRowKey(null);
for(int i = 1; i<=19; ++i)
{
model.setRowIndex(i);
treeState.setContained(true);
}
model.setRowIndex(oldIndex);
disclosedRowKeys = treeState;
}
return disclosedRowKeys;
}
ツリーおよびツリー表コンポーネントを使用すると、単一のノードのみまたは複数のノードを選択できるようになります。コンポーネントで複数の選択が許可されている場合、ユーザーは[Ctrl]を押しながらクリックする操作、および[Shift]を押しながらクリックする操作で複数のノードを選択できます。
ユーザーがノードを選択または選択解除すると、ツリー・コンポーネントによりselectionEventイベントが起動されます。このイベントには、選択解除されたすべてのノード用のRemovedSetオブジェクトと、選択されたすべてのノード用のAddedSetの2つのRowKeySetオブジェクトがあります。
ツリーおよびツリー表コンポーネントは、クラスoracle.adf.view.rich.model.RowKeySetのインスタンスを使用して選択されたノードを追跡します。このインスタンスは、コンポーネントのselectedRowKeys属性として格納されます。このインスタンスを使用して、階層内のノードの選択状態をプログラムで制御できます。RowKeySetインスタンスに含まれるノードは選択されているとみなされ、その他すべてのノードは選択解除されているとみなされます。addAll()メソッドによりすべてのノードがセットに追加され、removeAll()メソッドによりすべてのノードがセットから削除されます。ツリーおよびツリー表ノードの選択は、表の行の選択と同じように機能します。表の行選択のサンプル・コードは、10.2.8項「表の選択された行でのアクションの実行について」を参照してください。
ADF Facesのツリー表コンポーネントでは、表形式で階層データが表示されます。ツリー表コンポーネントでは、階層の各ツリー・ノードのデータの列を表示できるため、ツリー表コンポーネントの表示はツリー・コンポーネントの表示より複雑です。コンポーネントには、階層のノードの開閉だけでなく、メイン・ツリー内のサブツリーにフォーカスするメカニズムもあります。図10-21に、File Explorerアプリケーションで使用されるツリー表を示します。ツリー・コンポーネント同様、ツリー表でも、コレクションのファイル間の階層関係を表示できます。また、表コンポーネントと同じように、各ファイルの属性値も表示できます。
ツリー表コンポーネントの直下の子は、表コンポーネントと同じように、列コンポーネントであることが必要です。表とは異なり、ツリー表コンポーネントには、階層のノードの1次識別子を含む列が配置されるnodeStampファセットがあります。treeTableコンポーネントでは、Treeコンポーネントと同じスタンプ設定動作がサポートされています(詳細は、10.5項「ツリーへのデータの表示」を参照してください)。
たとえば、(図10-21に示す)File Explorerアプリケーションの1次識別子はファイル名です。これは、nodeStampファセットに含まれる列です。タイプや「サイズ」などのその他の列は、1次識別子の属性値を表示し、ツリー表コンポーネントの直接の子です。このツリー表では、nodeStampファセット列の各ノードのデータ、および子の列の各コンポーネントのデータにスタンプを設定するために使用される変数の値としてnodeが使用されています。例10-17に、File Explorerアプリケーション内のツリー表の省略形のコードを示します。
例10-17 treeTableの行へのスタンプ設定
<af:treeTable id="folderTreeTable" var="file"
value="#{explorer.contentViewManager.treeTableContentView.
contentModel}"
binding="#{explorer.contentViewManager.treeTableContentView.
contentTreeTable}"
emptyText="#{explorerBundle['global.no_row']}"
columnStretching="last"
rowSelection="single"
selectionListener="#{explorer.contentViewManager.
treeTableContentView.treeTableSelectFileItem}"
summary="treeTable data">
<f:facet name="nodeStamp">
<af:column headerText="#{explorerBundle['contents.name']}"
width="200" sortable="true" sortProperty="name">
<af:panelGroupLayout>
<af:image source="#{file.icon}"
shortDesc="#{file.name}"
inlineStyle="margin-right:3px; vertical-align:middle;"/>
<af:outputText id="nameStamp" value="#{file.name}"/>
</af:panelGroupLayout>
</af:column>
</f:facet>
<f:facet name="pathStamp">
<af:panelGroupLayout>
<af:image source="#{file.icon}"
shortDesc="#{file.name}"
inlineStyle="margin-right:3px; vertical-align:middle;"/>
<af:outputText value="#{file.name}"/>
</af:panelGroupLayout>
</f:facet>
<af:column headerText="#{explorerBundle['contents.type']}">
<af:outputText id="typeStamp" value="#{file.type}"/>
</af:column>
<af:column headerText="#{explorerBundle['contents.size']}">
<af:outputText id="sizeStamp" value="#{file.property.size}"/>
</af:column>
<af:column headerText="#{explorerBundle['contents.lastmodified']}"
width="140">
<af:outputText id="modifiedStamp"
value="#{file.property.lastModified}"/>
</af:column>
</af:treeTable>
ツリー表コンポーネントでは、表とツリーの両方と同じ多くの属性がサポートされています。これらの属性の詳細は、10.2項「表へのデータの表示」および10.5項「ツリーへのデータの表示」を参照してください。
ツリー表を作成するには、ツリー表の挿入ウィザードを使用します。ウィザードが完了したら、プロパティ・インスペクタを使用して、ツリー表の追加の属性を構成します。
ページにツリー表を追加する手順:
コンポーネント・パレットの「共通コンポーネント」パネルから、ページに「ツリー表」をドラッグ・アンド・ドロップし、ツリー表の挿入ウィザードを開きます。ウィザードを完了することで表を構成します。ヘルプを参照するには、[F1]を押すか「ヘルプ」をクリックします。
プロパティ・インスペクタを使用して、その他の属性を構成します。
|
ヒント: ツリー表の属性は、表およびツリー・コンポーネントの属性と同じです。属性の構成の詳細は、10.2.4項「ページへの表の表示方法」および10.5.1項「ツリーへのデータの表示方法」を参照してください。 |
コレクションから行全体を値として渡すことが必要になる場合があります。これを実行するには、表で行を表すために使用された変数、またはツリーでノードを表すために使用された変数を渡し、pageFlowスコープのプロパティに値として渡します。これにより、別のページでその値にスコープからアクセスできます。setPropertyListenerタグを使用すると、これを実行できます(使用の手順を含め、setPropertyListenerタグの詳細は、4.8項「ページ間の値の受渡し」を参照してください)。
たとえば、例10-18に示すように、従業員が表示された単一選択の表を含むマスター・ページがあり、ユーザーが行を1つ選択してコマンド・ボタンをクリックすると、その行のデータを編集するための新しいページにナビゲートできるようにするとします。EL変数名empは、表の1行(従業員)を表すために使用されます。commandButtonコンポーネントのaction属性値は、ユーザーによる「Employee Detail」ページへのナビゲートを可能にする静的な文字列結果showEmpDetailです。setPropertyListenerタグにはfrom値(変数emp)が使用され、toの値に格納されます。
例10-18 setPropertyListener and pageFlowScopeの使用
<af:table value="#{myManagedBean.allEmployees}" var="emp"
rowSelection="single">
<af:column headerText="Name">
<af:outputText value="#{emp.name}"/>
</af:column>
<af:column headerText="Department Number">
<af:outputText value="#{emp.deptno}"/>
</af:column>
<af:column headertext="Select">
<af:commandButton text="Show more details" action="showEmpDetail">
<af:setPropertyListener from="#{emp}"
to="#{pageFlowScope.empDetail}"
type="action"/>
</af:commandButton>
</af:column>
</af:table>
ユーザーが従業員行のコマンド・ボタンをクリックすると、リスナーが実行され、表の現在行(従業員)に対応する#{emp}の値が取得されます。取得された行オブジェクトは、#{pageFlowScope.empDetail} EL式を使用してpageFlowScopeのempDetailプロパティとして格納されます。静的結果によりアクション・イベントが実行され、ユーザーは詳細ページにナビゲートされます。詳細ページでは、例10-19に示すように、outputTextコンポーネントは、pageFlowScope.empDetailオブジェクトから値を取得します。
例10-19 pageFlowScopeオブジェクトの取得
<h:panelGrid columns="2">
<af:outputText value="Firstname:"/>
<af:inputText value="#{pageFlowScope.empDetail.name}"/>
<af:outputText value="Email:"/>
<af:inputText value="#{pageFlowScope.empDetail.email}"/>
<af:outputText value="Hiredate:"/>
<af:inputText value="#{pageFlowScope.empDetail.hiredate}"/>
<af:outputText value="Salary:"/>
<af:inputText value="#{pageFlowScope.empDetail.salary}"/>
</h:panelGrid>
panelCollectionコンポーネントを使用して、表、ツリーおよびツリー表にメニュー、ツールバーおよびステータス・バーを追加できます。panelCollectionコンポーネントを使用するには、表、ツリーまたはツリー表コンポーネントをpanelCollectionコンポーネントの直接の子として追加します。panelCollectionコンポーネントには、デフォルトのメニューとツールバー・ボタンが用意されています。
図10-22に、ツリー表コンポーネントを含む、File ExplorerアプリケーションのpanelCollectionコンポーネントを示します。ツールバーには、ツリー表で実行可能なアクション(ノードの開閉など)を提供するメニュー、ユーザーがツリー表を連結解除できるボタン、およびユーザーがツリー表に表示された行を変更できるボタンが含まれます。ツールバーに特定のツールバー項目を表示しないように構成できます。たとえば、ユーザーがツリーまたは表を連結解除できるようにするボタンを無効にできます。メニュー、ツールバーおよびツールバー・ボタンの詳細は、第14章「メニュー、ツールバーおよびツールボックスの使用方法」を参照してください。
他のファセットでは、panelCollectionコンポーネントには、メニュー・コンポーネントを保持するmenuファセット、ツールバー・コンポーネント用のtoolbarファセット、別のツールバー・コンポーネント・セット用のsecondaryToolbarファセット、およびステータス項目用のstatusbarファセットが含まれています。
デフォルトのトップレベルのメニューおよびツールバー項目は、panelCollectionコンポーネントの子として使用されているコンポーネントにより異なります。
表およびツリー: デフォルトのトップレベルのメニューは表示です。
選択可能な列が含まれる表およびツリー表: デフォルトのトップレベルのメニュー項目は表示およびフォーマットです。
表およびツリー表: デフォルトのツールバー・メニューは「連結解除」です。
選択可能な列が含まれる表およびツリー表: デフォルトのトップレベルのツールバー項目は「固定」、「連結解除」および「折返し」です。
ツリーおよびツリー表(pathStampファセットが使用されている場合): ツールバー・ボタン「上に移動」、「先頭に移動」および「先頭として表示」も表示されます。
例10-20に、panelCollectionコンポーネントにどのようにメニューおよびツールバーが含まれるかを示します。
例10-20 表、メニューおよびツールバーを含むpanelCollectionコンポーネント
<af:panelCollection
binding="#{editor.component}">
<f:facet name="viewMenu">
<af:group>
<af:commandMenuItem text="View Item 1..."/>
<af:commandMenuItem text="View Item 2.."/>
<af:commandMenuItem text="View Item 3..." disabled="true"/>
<af:commandMenuItem text="View Item 4"/>
</af:group>
</f:facet>
<f:facet name="menus">
<af:menu text="Actions">
<af:commandMenuItem text="Add..." />
<af:commandMenuItem text="Create.." />
<af:commandMenuItem text="Update..." disabled="true"/>
<af:commandMenuItem text="Copy"/>
<af:commandMenuItem text="Delete"/>
<af:commandMenuItem text="Remove" accelerator="control A"/>
<af:commandMenuItem text="Preferences"/>
</af:menu>
</f:facet>
<f:facet name="toolbar">
<af:toolbar>
<af:commandToolbarButton shortDesc="Create" icon="/new_ena.png">
</af:commandToolbarButton>
<af:commandToolbarButton shortDesc="Update" icon="/update_ena.png">
</af:commandToolbarButton>
<af:commandToolbarButton shortDesc="Delete" icon="/delete_ena.png">
</af:commandToolbarButton>
</af:toolbar>
</f:facet>
<f:facet name="secondaryToolbar">
</f:facet>
<f:facet name="statusbar">
<af:toolbar>
<af:outputText id="statusText" ... value="Custom Statusbar Message"/>
</af:toolbar>
</f:facet>
<af:table rowselection="multiple" columnselection="multiple"
...
<af:column
...
</af:column>
|
ヒント:
|
panelCollectionコンポーネントを追加してから、panelCollectionコンポーネントに表、ツリーまたはツリー表を追加します。その後、メニューおよびツールバーを追加および変更できます。
集約表示のコンポーネントを含むpanelCollectionコンポーネントを作成する手順:
コンポーネント・パレットの「レイアウト」パネルから、ページに「パネル・コレクション」をドラッグ・アンド・ドロップします。表、ツリーまたはツリー表をそのコンポーネントの子として追加します。
または、ページに表、ツリーまたはツリー表がすでに存在している場合は、コンポーネントを右クリックして「囲む」を選択します。次に「パネル・コレクション」を選択して、panelCollectionコンポーネントでコンポーネントを囲みます。
オプションで、特定のツールバーとメニュー項目を無効にして、panelCollectionツールバーをカスタマイズします。これを実行するには、構造ウィンドウでpanelCollectionコンポーネントを選択します。プロパティ・インスペクタで、featuresOff属性を設定します。表10-1に、有効な値およびツールバーへのそれぞれの影響を示します。
表10-1 featuresOff属性の有効値
| 値 | 表示されない項目 |
|---|---|
|
|
ステータス・バー |
|
|
「表示」メニュー |
|
|
「書式設定」メニュー |
|
|
「表示」メニューの「列」メニュー |
|
例: |
「列」メニューのIDに一致する列 たとえば、左側の値には、IDが |
|
|
「表示」メニューの「固定」メニュー項目 |
|
|
「表示」メニューの「連結解除」メニュー項目 |
|
|
「表示」メニューの「ソート」メニュー項目 |
|
|
「表示」メニューの「列の並替え」メニュー項目 |
|
|
「書式設定」メニューの「列のサイズ変更」メニュー項目 |
|
|
「書式設定」メニューの「折返し」メニュー項目 |
|
|
ツリーの「表示」メニューの「先頭として表示」メニュー項目 |
|
|
ツリーの「表示」メニューの「最初にスクロール」メニュー項目 |
|
|
ツリーの「表示」メニューの「最後にスクロール」メニュー項目 |
|
|
「固定」ツールバーの項目 |
|
|
「連結解除」ツールバーの項目 |
|
|
「折返し」ツールバーの項目 |
|
|
「先頭として表示」ツールバーの項目 |
|
|
「折返し」メニューおよびツールバーの項目 |
|
|
「固定」メニューおよびツールバーの項目 |
|
|
「連結解除」メニューおよびツールバーの項目 |
コンポーネントにカスタムのメニューおよびツールバーを追加します。
メニュー: menuファセットにmenuコンポーネントを追加します。
ツールバー: toolbarまたはsecondaryToolbarファセットにtoolbarコンポーネントを追加します。
ステータス項目: statusbarファセットに項目を追加します。
ビュー・メニュー: viewMenuファセットにcommandMenuItemコンポーネントを追加します。複数項目の場合は、多数のcommandMenuItemコンポーネントのコンテナとしてgroupコンポーネントを使用します。
コンポーネント・パレットから、ファセットにコンポーネントをドラッグ・アンド・ドロップします。たとえば、menuファセットにメニューをドロップし、同じファセットに「メニュー項目」をドロップしてメニュー・リストを作成します。メニューおよびツールバーの詳細は、第14章「メニュー、ツールバーおよびツールボックスの使用方法」を参照してください。
表、ツリーまたはツリー表、またはDVTプロジェクト・ガント・チャートの表領域からデータをMicrosoft Excelのスプレッドシートにエクスポートできます。ユーザーが表をエクスポートできるようにするには、コマンド・ボタンやコマンド・リンクなどのアクション・ソースを作成し、exportCollectionActionListenerコンポーネントを追加して、エクスポートするデータを関連付けます。すべての行がエクスポートされるように、またはユーザーが選択した行のみがエクスポートされるように表を構成できます。
たとえば、図10-23に、ユーザーがExcelのスプレッドシートにデータをエクスポートできるコマンド・ボタン・コンポーネントが含まれるADF Facesデモの表を示します。
ユーザーがコマンド・コンポーネントをクリックすると、リスナーにより、すべての行のExcelへのエクスポートが処理されます。図10-23に示すように、ユーザーが選択する行のみがエクスポートされるように、exportCollectionActionListenerコンポーネントを構成することも可能です。
|
注意: 次のものしかエクスポートできません。
|
ブラウザ、およびリスナーの構成によって異なりますが、図10-24に示すように、ユーザーがスプレッドシートを開くか保存することができるダイアログがブラウザによって開かれるか、ブラウザにスプレッドシートが表示されます。たとえば、ユーザーがMicrosoft Internet Explorerでページを表示していて、exportCollectionActionListenerコンポーネントにファイル名が指定されていない場合、ファイルはブラウザに表示されます。Mozilla Firefoxでは、ダイアログが開かれます。
ユーザーがファイルの保存を選択した場合、図10-25に示すように、後からExcelで開くことができます。ユーザーがファイルを開くことを選択した場合、その後の動作はブラウザにより異なります。たとえば、ユーザーがMicrosoft Internet Explorerでページを表示している場合、ブラウザ・ウィンドウにスプレッドシートが表示されます。ユーザーがMozilla Firefoxでページを表示している場合は、スプレッドシートがExcelで開かれます。
|
注意: ファイルがファイルの拡張子で指定された形式と異なる旨の警告がExcelで表示される場合があります。この警告は無視して問題ありません。 |
ボタン、リンクまたはメニュー項目などのコマンド・コンポーネントを作成し、そのコンポーネントにexportCollectionActionListenerを追加します。その後、exportCollectionActionListenerコンポーネントのexportedId属性を、データをエクスポートするコレクション・コンポーネントIDに設定して、エクスポートするデータ・コレクションを関連付けます。
作業を始める前に、次のようにします。
ページに表、ツリーまたはツリー表が存在している必要があります。ない場合は、この章の指示に従って表、ツリーまたはツリー表を作成します。たとえば、表を追加するには、10.2項「表へのデータの表示」を参照してください。
外部形式にコレクション・データをエクスポートする手順:
コンポーネント・パレットの「共通コンポーネント」パネルから、ボタンなどのコマンド・コンポーネントをページにドラッグ・アンド・ドロップします。
|
ヒント: 表、ツリーまたはツリー表にコマンド・コンポーネントのあるツールバーを作成する場合は、コレクション・コンポーネントを |
コマンド・コンポーネントのデフォルトのラベルを、意味のある名前(Export to Excelなど)に変更することが必要な場合があります。
コンポーネント・パレットの「操作」パネルから、「エクスポート・コレクション・アクション・リスナー」をコマンド・コンポーネントの子としてドラッグします。
「エクスポート・コレクション・アクション・リスナー」ダイアログで、次の設定を行います。
exportedId: エクスポートする表、ツリーまたはツリー表のIDを指定します。手動で入力するか、ドロップダウン・メニューを使用して「編集」を選択します。「プロパティの編集」ダイアログを使用して、コンポーネントを選択します。
type: excelHTMLに設定します。
exportCollectionActionListenerコンポーネントが選択された状態で、プロパティ・インスペクタで次の設定を行います。
filename: エクスポートするコンテンツの選択したファイル名を指定します。この属性を設定すると、通常は「ファイルの保存」ダイアログが表示されますが、最終的にはブラウザにより異なります。この属性を設定しない場合、通常、コンテンツはブラウザにインライン表示されます(可能な場合)。
title: エクスポートするドキュメントのタイトルを指定します。タイトルが表示されるかどうかや、どのように表示されるかは、Excelに依存します。
exportedRows: 表のすべての行をエクスポートするか、ユーザーが選択した行のみをエクスポートするかを指定します。表でdetailStampファセットが使用されている場合は、データをエクスポートするかどうかを選択できます(detailStampファセットの詳細は、10.3項「表への非表示機能の追加」を参照してください)。次のいずれかを設定します。
all: すべての行が自動的に選択され、エクスポートされます。
selected: ユーザーが選択した行のみがエクスポートされます。
allWithoutDetails: detailStampファセットのデータを除くすべての行が選択され、エクスポートされます。
selectedWithoutDetails: ユーザーが選択した行のみがエクスポートされます(detailStampファセットのデータを除く)。
例10-21に、表およびそのexportCollectionActionListenerコンポーネントのコードを示します。exportedId値が、表のid値に設定されていることに注意してください。
例10-21 exportCollectionActionListenerを使用した表のエクスポート
<af:table contextMenuId="thePopup" selectionListener="#{fs.Table}"
rowselection="multiple" columnselection="multiple"
columnBandingInterval="1"
binding="#{editor.component}" var="test1" value="#{tableTestData}"
id="table" summary="table data">
<af:column>
. . .
</af:column>
</af:table>
<af:commandButton text="Export To Excel" immediate="true">
<af:exportCollectionActionListener type="excelHTML" exportedId="table"
filename="export.xls" title="ADF Faces Export"/>
リッチ・クライアント・フレームワークでは、クライアント側でELがサポートされないのみでなく、クライアントへの表モデル全体の送信もサポートされていないため、JavaScriptを使用してクライアント上の値にアクセスする必要がある場合、クライアント側のコードは、値にアクセスするためにスタンプ設定するコンポーネントに依存できません。各行で同じコンポーネント・インスタンスを再利用するかわりに、完全に解決されるEL式を使用して、各行に新しいJavaScriptコンポーネントが作成されます(どの行にもコンポーネントが1つ作成される必要があると仮定しています)。
そのため、クライアント上の行固有のデータにアクセスするには、それ自体がスタンプ設定されたコンポーネントを使用して値にアクセスする必要があります。クライアント側のデータ・モデルを使用せずにこれを実現するには、クライアント側の選択変更リスナーを使用します。
スタンプ設定されたコンポーネントからクライアント上の値にアクセスするには、まずコンポーネントにクライアント表現があることを確認する必要があります。次に、クライアントに選択変更リスナーを登録し、そのリスナー・ハンドルで選択された行を判別して、その行のスタンプ設定された関連するコンポーネントを検索できるようにし、スタンプ設定されたコンポーネントを使用して行固有の名前を判別し、最後に、必要に応じて選択されたデータと通信する必要があります。
スタンプ設定されたコンポーネントから選択された値にアクセスする手順:
ページの構造ウィンドウで、スタンプ設定された行に関連付けられたコンポーネントを選択します。たとえば、例10-22の表では、outputTextコンポーネントを使用してスタンプ設定された行が表示されています。
例10-22 スタンプ設定された行にoutputTextコンポーネントが使用されている表コンポーネント
<af:table var="row" value="#{data}" rowSelection="single">
<af:column headerText="Name">
<af:outputText value="#{row.name}"/>
</af:column>
</af:table>
コンポーネントに次の設定を行います。
プロパティ・インスペクタの「共通」セクションを開き、Id属性を使用してコンポーネントに一意のIDを設定します(まだ定義されていない場合)。
「拡張」セクションを開き、ClientComponent属性をTrueに設定します。
コンポーネント・パレットの「操作」パネルから、client Listenerを表の子としてドラッグ・アンド・ドロップします。
「クライアント・リスナーの挿入」ダイアログで、「メソッド」フィールドに関数名(次の手順でこの関数を実装します)を入力し、「タイプ」ドロップダウンからselectionを選択します。
たとえば、関数としてmySelectedRowを入力した場合、JDeveloperにより、例10-23に太字で示されたコードが入力されます。
例10-23 選択を登録するためのclientListenerの使用
<af:table var="row" value="#{data}" rowSelection="single">
<af:clientListener type="selection" method="mySelectedRow"/>
...
</af:table>
このコードにより、mySelectedRow関数は、選択内容が変更されるたびにコールされます。
JavaScriptライブラリで、前の手順で入力された関数を実装します。この関数により、次の操作が実行されます。
選択された行を把握します。これを行うには、リスナーに渡されるイベント・オブジェクトを使用します。選択イベントの場合、イベント・オブジェクトのタイプはAdfSelectionEventです。このタイプを使用すると、getAddedSet()経由で新たに選択された行キーにアクセスできるようになり、選択された各行キーのプロパティが含まれるPOJSO(プレーンの古いJavaScriptオブジェクト)が返されます。このオブジェクトにアクセスしたら、for inループを使用して行キーを反復できます。たとえば、例10-24のコードでは、最初の行キー(この場合は唯一の行キー)が抽出されます。
選択済の行に関連付けられているスタンプ設定されたコンポーネントを検索します。クライアント側のコンポーネントAPI AdfUIComponentは、findComponent()メソッドを公開し、このメソッドでは、コンポーネントのIDを取得し、AdfUIComponentインスタンスを検索して返します。スタンプ設定されたコンポーネントを使用する際は、IDだけでなく、行キーも使用してコンポーネントを検索する必要があります。これをサポートするために、AdfUITableクラスには、IDと行キーの両方を取得するfindComponent()のオーバーロードのメソッドが用意されています。
選択イベントの場合、コンポーネントはイベントのソースです。そのため、イベントのソースから表を取得し、その表を使用してIDおよび行キーでインスタンスを検索します。例10-25に、これを示します(この例では、nameStampが表のIDです)。
例10-25 選択された行を指定したスタンプ設定されたコンポーネント・インスタンスの検索
// We need the table to find our stamped component.
// Fortunately, in the case of selection events, the
// table is the event source.
var table = event.getSource();
// Use the table to find the name stamp component by id/row key:
var nameStamp = table.findComponent("nameStamp", firstRowKey);
コンポーネントを使用するために必要なその他のコードを追加します。スタンプ設定されたコンポーネントを検出したら、その他のコンポーネントの場合と同じように通信できます。たとえば、例10-26に、スタンプ設定されたコンポーネントを使用してname属性の行固有の値(例10-22で示したスタンプ設定された値)を取得し、アラートに名前を表示する方法を示します。
例10-27にJavaScriptの全コードを示します。
例10-27 選択された行の値へのアクセスに使用されるJavaScript
function showSelectedName(event)
{
var firstRowKey;
var addedRowKeys = event.getAddedSet();
for (var rowKey in addedRowKeys)
{
firstRowKey = rowKey;
break;
}
// We need the table to find our stamped component.
// Fortunately, in the case of selection events, the
// table is the event source.
var table = event.getSource();
// We use the table to find the name stamp component by id/row key:
var nameStamp = table.findComponent("nameStamp", firstRowKey);
if (nameStamp)
{
// This is the row-specific name
var name = nameStamp.getValue();
alert("The selected name is: " + name);
}
}
行キーはサーバーでトークン化され、クライアントの行キーには、サーバーの行キーとの類似点はありません。たとえば、クライアント側のAPI(AdfSelectionEvent.getAddedSet()など)によって処理される行キーのみが有効です。
また、対応する行がスクロールされて画面から見えなくなっていて、クライアントで使用できない場合には、AdfUITable.findComponent(id, rowKey)メソッドによりnullが戻される可能性があることに注意してください。AdfUITable.findComponent()メソッドの戻り値にnullがないか必ず確認してください。
