「データにバインド」ダイアログ: リストコンポーネント

関連項目

このダイアログでは、リスト項目を表示するコンポーネントの「 items 」プロパティーにデータプロバイダまたはオブジェクトを関連付けることができます。この関連付けを作成することによって、コンポーネントのリスト内の項目を実行時に変更することができます。

このダイアログは、Visual Web JSF ページに追加した基本リストボックス、チェックボックスグループ、ラジオボタングループ、ドロップダウンリストいずれかのコンポーネントを右クリックし、「データにバインド」を選択した場合に開きます。

ダイアログの一番上のフィールドは、コンポーネントの「 items 」プロパティーの現在の設定を示します。デフォルトでは、このプロパティーは、リストを埋めているデフォルトオブジェクトの「 options 」プロパティーにバインドされています。たとえば dropDown1 というドロップダウンリストの場合、このオブジェクトは dropDown1DefaultOptions です。

バインドを設定するには、目的の種類のバインドを行うタブ、すなわち「データプロバイダにバインド」または「オブジェクトにバインド」のいずれかを選択します。

データプロバイダにバインド

このタブでは、コンポーネントのプロパティーを、このダイアログを開く前にページに追加した データベース列 にバインドできます。

表示されたデータプロバイダに使用するプロバイダがない場合は、「<コンポーネント名>にバインドするデータプロバイダを選択」ドロップダウンリストから別のデータプロバイダを選択します。このドロップダウンリストにも使用するプロバイダがない場合は、アプリケーションに応じて、データベース表をページに追加する必要があります。

データプロバイダを選択すると、そのデータプロバイダからの項目を使用して「値フィールド」および「表示フィールド」リストが生成されます。データプロバイダが表すオブジェクトに応じて、これらリスト内の項目は、データベース列か Web サービスメソッド、またはエンタープライズ Bean メソッドを表すことができます。2 つの列はそれぞれ、ページ上のコンポーネントが表示するリスト項目の異なる側面を表します。

コンポーネントのリストを埋めるのに使用するすべての項目を選択します。

項目を選択すると、ダイアログの一番上の入力フィールドに、選択された項目を参照する JavaServer Faces 式が自動的に設定されます。

選択に問題がなければ、「了解」をクリックして、コンポーネントの「 items 」プロパティーにバインドを適用します。

オブジェクトにバインド

このタブでは、コンポーネントのプロパティーを JavaBean プロパティーにバインドできます。必要に応じて独自の JavaBeans オブジェクトを作成し、リスト項目を制御できます。プロパティーを選択し、「了解」をクリックするとプロパティーをバインドできます。

デフォルトでは、リストコンポーネントの「items」プロパティーは、リストを生成するために IDE が生成するオブジェクトの「options」プロパティーにバインドされています。一般には、このオブジェクトは、ページ上でコンポーネントを右クリックし、「デフォルトオプションを設定」を選択することによって操作します。また、独自のオブジェクトを作成して、リストを生成することもできます。

たとえば dropDown1 という JavaServer Faces 1.2 のドロップダウンリスト用に作成した JavaBeans オブジェクトの名前は、dropDown1DefaultOptions です。このオブジェクトの「Options」プロパティーは com.sun.webui.jsf.model.Option オブジェクトからなる配列で、これらのオブジェクトにはそれぞれに String 型の「ラベル」(リスト内の表示値) と Object 型の「値」(リスト項目の値) の 2 つのフィールドがあります。

関連項目
チェックボックスグループコンポーネント
ドロップダウンリストコンポーネント
リストボックスコンポーネント
ラジオボタングループコンポーネント
データへのコンポーネントのバインドについて
コンポーネントとデータについて

著作権と商標について