Utilità fornite dai componenti JSF di Business Process Choreographer Explorer

I componenti JSF (JavaServer Faces) forniscono le utilità per le informazioni sul fuso orario e sulla gestione errori specifiche per l'utente.

Informazioni sul fuso orario specifiche per l'utente

La classe BPCListHandler utilizza l'interfaccia com.ibm.bpc.clientcore.util.User per ottenere informazioni sul fuso orario e sulle informazioni internazionali per ciascun utente. Il componente Elenco prevede l'implementazione dell'interfaccia da configurare con l'utente come nome del bean gestito nel file JSF (JavaServer Faces). Se questa voce manca dal file di configurazione, viene restituito il fuso orario in cui WebSphere Process Server è in esecuzione.

L'interfaccia com.ibm.bpc.clientcore.util.User viene definita come segue:
public interface User {

    /**
     * Le impostazioni internazionali utilizzate dal client dell'utente.
     * @return Locale.
     */
    public Locale getLocale();
   /**
    * Il fuso orario utilizzato dal client dell'utente.    
    * @return TimeZone.
    */
    public TimeZone getTimeZone();

   /**
    * Il nome dell'utente.
    * @return name of the user.
    */
    public String getName();
}

Interfaccia ErrorBean per la gestione degli errori

I componenti JSF sfruttano un bean gestito predefinito, BPCError, per la gestione degli errori. Questo bean implementa l'interfaccia com.ibm.bpc.clientcore.util.ErrorBean. In situazioni di errore che eseguono il trigger della pagina di errore, l'eccezione viene impostata sul bean di errore. La pagina di errore viene visualizzata nelle seguenti situazioni:
  • Se si verifica un errore durante l'esecuzione di una query definita per un gestore elenchi e l'errore è generato come errore ClientException dal metodo execute di un comando
  • Se un errore ClientException è generato dal metodo execute di un comando e questo errore non è un errore ErrorsInCommandException né implementa l'interfaccia CommandBarMessage
  • Se viene visualizzato un messaggio di errore nel componente e si segue il collegamento ipertestuale per il messaggio

È disponibile un'implementazione predefinita dell'interfaccia com.ibm.bpc.clientcore.util.ErrorBeanImpl.

L'interfaccia viene definita nel modo seguente:
public interface ErrorBean {

    public void setException(Exception ex);
    
    /*
     * Questo richiamo del metodo setter consente di inoltrare 
     * le impostazioni internazionali e l'eccezione. Ciò consente ai metodi 
     * getExceptionMessage di restituire le stringhe localizzate
     *
     */
    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();
    
    /*
     * Questo metodo restituisce il messaggio di eccezione 
     * concatenato in modo ricorsivo con i messaggi di tutte 
     * le eccezioni nidificate.
     */
    public String getAllExceptionMessages();
    
    /*
     * Questo metodo restituisce l'accodamento dell'eccezione 
     * concatenato in modo ricorsivo agli accodamenti di tutte 
     * le eccezioni nidificate.
     */
    public String getAllExceptionStacks();
}

(c) Copyright IBM Corporation 2005, 2006.
This information center is powered by Eclipse technology (http://www.eclipse.org)