List コンポーネントのインスタンスはすべて com.ibm.bpe.jsf.handler.BPCListHandler クラスのインスタンスに関連しています。
このリスト・ハンドラーは関連するリスト内で選択された項目をトラッキングし、さまざまな種類の項目用の詳細ページにリスト項目を関連付ける通知メカニズムを提供します。 リスト・ハンドラーは、bpe:list タグの model 属性を介して List コンポーネントにバインドされます。
リスト・ハンドラーの通知メカニズムは、com.ibm.bpe.jsf.handler.ItemListener インターフェースを使用して実装されます。 このインターフェースの実装は、JavaServer Faces (JSF) アプリケーションの構成ファイルに登録できます。
リスト内のリンクがクリックされると、通知がトリガーされます。 action 属性が設定されているすべての列についてリンクがレンダリングされます。 action 属性の値は JSF ナビゲーション・ターゲットか、JSF ナビゲーション・ターゲットを戻す JSF アクション・メソッドのいずれかです。
BPCListHandler クラスは、refreshList メソッドを提供します。 このメソッドを JSF メソッド・バインディングで使用して、 照会を再実行するためのユーザー・インターフェース制御を実装することができます。
リスト・ハンドラーを使用すると、すべての種類のオブジェクトおよびそれらのプロパティーを表示できます。 表示されるリストの内容は、リスト・ハンドラー用に構成された com.ibm.bpc.clientcore.Query インターフェースの実装によって戻されるオブジェクトのリストによって異なります。 照会は、BPCListHandler クラスの setQuery メソッドを使用してプログラマチックに設定することもできますし、アプリケーションの JSF 構成ファイルで構成することもできます。
照会は、Business Process Choreographer API に対してだけでなく、 コンテンツ管理システムやデータベースなど、アプリケーションからアクセスできるその他の情報ソースに対しても実行できます。 要件は、照会の結果が execute メソッドで オブジェクトの java.util.List として戻されることだけです。
戻されるオブジェクトのタイプは、照会が定義されたリストの列に表示されるすべてのプロパティーに対して適切な getter メソッドを使用できることを保証する必要があります。 戻されるオブジェクトのタイプがリスト定義に適合することを確認するには、faces 構成ファイルで定義されている BPCListHandler インスタンス上のタイプ・プロパティーの値を、戻されるオブジェクトの完全修飾クラス名に設定します。 この名前は、照会実装の getType 呼び出しで戻すことができます。 実行時に、リスト・ハンドラーはオブジェクト・タイプが定義に準拠していることを確認します。
リスト内の特定の項目にエラー・メッセージをマップするには、照会によって戻されたオブジェクトが署名 public Object getID() でメソッドを実装する必要があります。
static public String getLabel(String property,Locale locale);
static public com.ibm.bpc.clientcore.converter.SimpleConverter
getConverter(String property);これらのメソッドが Bean に対して定義されている場合、List コンポーネントはリストのデフォルト・ラベルとして label を使用し、プロパティーのデフォルト・コンバーターとして SimpleConverter を使用します。 これらの設定は、bpe:list タグの label および converterID 属性で上書きできます。 詳しくは、SimpleConverter インターフェースおよび ColumnTag クラスの Javadoc を参照してください。