Programas de utilidad proporcionados por los componentes JSF del Explorador de Business Process Choreographer

Los componentes JSF (JavaServer Faces) proporcionan programas de utilidad para la información de huso horario específica del usuario y el manejo de errores.

Información de huso horario específica del usuario

La clase BPCListHandler utiliza la interfaz com.ibm.bpc.clientcore.util.User para obtener información sobre el huso horario y el entorno local de cada usuario. El componente de lista espera que la implementación de la interfaz se configure con user como el nombre de bean gestionado en el archivo de configuración JSF (JavaServer Faces). Si faltara esta entrada en el archivo de configuración, se devolvería el huso horario en el que se ejecuta WebSphere Process Server.

La interfaz com.ibm.bpc.clientcore.util.User se define de la siguiente manera:
public interface User {

    /**
     * El entorno local utilizado por el cliente del usuario.
     * @return El entorno local.
     */
    public Locale getLocale();
   /**
    * El huso horario utilizado por el cliente del usuario.    
    * @return El huso horario.
    */
    public TimeZone getTimeZone();

   /**
    * El nombre del usuario.
    * @return el nombre del usuario.
    */
    public String getName();
}

Interfaz ErrorBean para el manejo de errores

A veces, los componentes JSF aprovechan un bean gestionado predefinido, BPCError, para el manejo de errores. Este bean implementa la interfaz com.ibm.bpc.clientcore.util.ErrorBean. En situaciones de error que desencadenan la página de errores, se establece la excepción en el bean de error. La página de errores se muestra en estas situaciones:
  • Si se produce un error durante la ejecución de una consulta que se defiine para un manejador de listas y el método execute de un mandato genera el error como un error de ClientException
  • Si el método execute de un mandato genera un error de ClientException y este error no es un error de ErrorsInCommandException ni tampoco implementa la interfaz CommandBarMessage
  • Si se muestra una mensaje de error en el componente y sigue el hiperenlace del mensaje

Está disponible una implementación por omisión de la interfaz com.ibm.bpc.clientcore.util.ErrorBeanImpl.

La interfaz se define como se detalla a continuación:
public interface ErrorBean {

    public void setException(Exception ex);
    
    /*
     * Esta llamada al método setter permite que se pase un entorno local
     * y la excepción. Esto permite que los métodos
     * getExceptionMessage devuelvan series adaptadas
     *
     */
    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();
    
    /*
     * Este método devuelve el mensaje de excepción
     * concatenado recursivamente con los mensajes de todas
     * las excepciones anidadas.
     */
    public String getAllExceptionMessages();
    
    /*
     * Este método devuelve la pila de excepciones
     * concatenada recursivamente con las pilas de todas
     * las excepciones anidadas.
     */
    public String getAllExceptionStacks();
}

Condiciones de uso |

Última actualización: Wed Apr 19 21:34:07 2006

(c) Copyright IBM Corporation 2005, 2006.
Este centro de información está basado en tecnología Eclipse (http://www.eclipse.org)