クライアント・データの構成

注: 一部の Faces Client コンポーネントおよびクライアント・データの使用は推奨されません。
以下については、使用を推奨しません。
  • クライアント・データおよびその関連ツール (「クライアント・データ」ビューなど)
  • Faces Client コンポーネント
    • <odc:dataGrid> (データ・グリッド)
    • <odc:webService> (Web サービス)
    • <odc:clientData>
    • <odc:clientBinder>

クライアント・データは、ページ・データ・コンポーネントから得られます。クライアント・データは、JavaScript™ オブジェクトにフォーマットされ、ブラウザーに送信される JSP に組み込まれます。パフォーマンスがより向上するように、クライアント・データを構成することもできます。データから余分なものを取り除いて使用しない属性を除去し、クライアント属性を追加し、基礎となるデータ Bean に変更があった場合にクライアント・データを再生成することができます。 これらの機能は、「クライアント・データの構成 (Configure Client Data)」ダイアログで提供されます。

「クライアント・データ」ビューから「クライアント・データの構成」ダイアログにアクセスできます。 「クライアント・データ・オブジェクト」を強調表示し、右マウス・ボタンをクリックして 「構成する」を選択します。「クライアント・データの構成」ダイアログ・ボックスには「基本」と「拡張」の 2 つのタブがあります。 「基本」タブでは、クライアント・データから余分なものを取り除いたり、 クライアント属性を追加したりすることができます。「基本」タブでは、クライアント・データ・モデル名はオプションです。ポートレット間でクライアント・データ・オブジェクトを共用したい場合に、このフィールドを指定します。 Bean 内のプロパティーを 主キーの一部分としてマーク付けするために、 「主キー」チェック・ボックスを使用します。 これによって、パフォーマンスが向上します。

主キーの制限

ターゲット・サーバーが WebSphere® Application Server 5.1 の場合、主キーには java.util.Date 属性タイプを使用できません。

クライアント・データ属性の追加

「クライアント・データの構成」ダイアログ・ボックスの「基本」タブで、「クライアント属性の追加」を押して、クライアント・データ属性を追加できます。 ダイアログの下部で、以下を入力してください。
種類
これは、整数、浮動小数点、ブールなどのデータ型です。
名前
これは、属性の名前です。
これは、値または式です。
注: クライアント・データ属性を追加すると、クライアント属性が参照されるたびに、最新の値が使用されていることを確認するために供給された式が呼び出されるので、パフォーマンスに影響します。

ページ・データとクライアント・サイド・データの同期

ユーザーがページをサーバーに実行し直すと、クライアント・データは、サーバー上のデータを表すページ・データと同期することができます。この同期はデフォルトで使用可能です。 JavaBeans™、 関係レコード・リスト、関係レコード、および EGL レコードには自動更新がサポートされています。 ユーザーが独自の diff ハンドラーを書いて、 クライアント・データとページ・データを同期化したい場合、 「クライアント・データの構成」ダイアログの 「基本」タブで、「同期時にこの要素への 変更を除外する」を選択解除することによって、 この機能を停止することができます。

データ・グラフの整理

「クライアント・データ・モデル (Client Data models)」セクションで、 ノードの隣にあるチェック・ボックスを選択解除すると、 データ・グラフから余分なものを除去することができます。 グラフで表示したい情報だけを選択することで、 パフォーマンスが軽減され、 より分かりやすいグラフを作成することができます。

クライアント・データの除去および再生成

「クライアント・データの構成 (Configure Client Data)」ダイアログ・ボックスの「拡張」タブに、emap ソースのロード、 サーバー・サイド・データからの再生成、およびプロジェクトからのクライアント・データの除去を行う、いくつかのボタンがあります。

関連資料
Faces Client コンポーネント
Faces Client フレームワーク内での Faces コンポーネントのサポート
Faces Client コンポーネントのプロパティー
サポートされる JavaBean 文字とデータ型

フィードバック