Business Process Choreographer Explorer JSF コンポーネントによって提供されるユーティリティー

JavaServer Faces (JSF) コンポーネントは、ユーザー指定の時間帯情報およびエラー処理のためのユーティリティーを提供します。

ユーザー固有の時間帯情報

BPCListHandler クラスは、 com.ibm.bpc.clientcore.util.User インターフェースを使用して、 各ユーザーの時間帯およびロケールに関する情報を取得します。 List コンポーネントは、JavaServer Faces (JSF) 構成ファイルで インターフェースのインプリメンテーションが user を管理対象 Bean 名として設定されていると予期します。 構成ファイル内でこの項目が欠けている場合は、 WebSphere Process Server が動作している時間帯が戻されます。

com.ibm.bpc.clientcore.util.User インターフェースは次のように定義されています。
public interface User {

    /**
     * The locale used by the client of the user.
     * @return Locale.
     */
    public Locale getLocale();
   /**
    * The time zone used by the client of the user.    
    * @return TimeZone.
    */
    public TimeZone getTimeZone();

   /**
    * The name of the user.
    * @return name of the user.
    */
    public String getName();
}

エラー処理用の ErrorBean インターフェース

JSF コンポーネントはエラー処理の際に、事前定義された管理対象 Bean である BPCError を 活用します。 この Bean は、com.ibm.bpc.clientcore.util.ErrorBean インターフェースをインプリメントします。 エラー・ページをトリガーするエラー状態では、例外がエラー Bean で設定されます。 エラー・ページが表示されるのは、次のような状態のときです。
  • リスト・ハンドラー用に定義された照会の実行中にエラーが発生し、 エラーがコマンドの execute メソッドによって ClientException エラーとして生成された場合
  • ClientException エラーがコマンドの execute メソッドによって生成され、 このエラーが ErrorsInCommandException エラーではなく、 CommandBarMessage インターフェースのインプリメントもしない場合
  • コンポーネント内でエラー・メッセージが表示され、メッセージのハイパーリンクに従っている場合

com.ibm.bpc.clientcore.util.ErrorBeanImpl インターフェースのデフォルト・インプリメンテーションを使用できます。

インターフェースは次のように定義されます。
public interface ErrorBean {

    public void setException(Exception ex);
    
    /*
     * This setter method call allows a locale and
     * the exception to be passed. This allows the
     * getExceptionMessage methods to return localized Strings
     *
     */
    public void setException(Exception ex, Locale locale);
    
    public Exception getException();
    public String getStack();
    public String getNestedExceptionMessage();
    public String getNestedExceptionStack();
    public String getRootExceptionMessage();
    public String getRootExceptionStack();
    
    /*
     * This method returns the exception message
     * concatenated recursively with the messages of all
     * the nested exceptions.
     */
    public String getAllExceptionMessages();
    
    /*
     * This method is returns the exception stack
     * concatenated recursively with the stacks of all
     * the nested exceptions.
     */
    public String getAllExceptionStacks();
}

(c) Copyright IBM Corporation 2005, 2006. All rights reserved.
(c) Copyright IBM Japan 2006
このインフォメーション・センターでは、Eclipse テクノロジー (http://www.eclipse.org) が採用されています。