Durch die JSF-Komponenten von Business Process Choreographer Explorer bereitgestellte Dienstprogramme

Die JSF-Komponenten stellen Dienstprogramme für benutzerspezifische Zeitzoneninformationen und die Fehlerbehandlung bereit.

Benutzerspezifische Zeitzoneninformationen

Die Klasse BPCListHandler verwendet die Schnittstelle com.ibm.bpc.clientcore.util.User, um Informationen zur Zeitzone und zur Ländereinstellung eines Benutzers abzurufen. Die Listenkomponente geht davon aus, dass die Implementierung der Schnittstelle mit dem Wert user als Name der Managed-Bean in der JSF-Konfigurationsdatei konfiguriert ist. Falls dieser Eintrag in der Konfigurationsdatei fehlt, wird die Zeitzone zurückgegeben, in der WebSphere Process Server ausgeführt wird.

Die Schnittstelle com.ibm.bpc.clientcore.util.User ist folgendermaßen definiert:
public interface User {

    /**
     * Vom Client des Benutzers verwendete Ländereinstellung.
     * @return Locale.
     */
    public Locale getLocale();
   /**
    * Vom Client des Benutzers verwendete Zeitzone.    
    * @return TimeZone.
    */
    public TimeZone getTimeZone();

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

Schnittstelle ErrorBean für die Fehlerbehandlung

Manchmal nutzen die JSF-Komponenten die vordefinierte Managed-Bean BPCError für die Fehlerbehandlung. Diese Bean implementiert die Schnittstelle com.ibm.bpc.clientcore.util.ErrorBean. In Fehlersituationen, die die Fehlerseite auslösen, ist für die Error-Bean eine Ausnahmebedingung festgelegt. Die Fehlerseite wird in den folgenden Situationen angezeigt:
  • Während der Ausführung einer Abfrage, die für einen Listenhandler definiert ist, tritt ein Fehler auf, und der Fehler wird als Fehler ClientException durch die Methode execute eines Befehls ausgelöst.
  • Ein Fehler ClientException wird durch die Methode execute eines Befehls ausgelöst, und dieser Fehler ist weder ein Fehler ErrorsInCommandException noch implementiert er die Schnittstelle CommandBarMessage.
  • In der Komponente wird eine Fehlernachricht angezeigt, und Sie wählen den Hyperlink für die Nachricht aus.

Für die Schnittstelle com.ibm.bpc.clientcore.util.ErrorBeanImpl gibt es eine Standardimplementierung.

Die Schnittstelle ist folgendermaßen definiert:
public interface ErrorBean {

    public void setException(Exception ex);
    
    /*
     * Dieser Aufruf der Setter-Methode ermöglicht die Übergabe
     * einer Ländereinstellung und der Ausnahmebedingung. Dadurch kann
     * die Methode getExceptionMessage übersetzte Zeichenfolgen zurückgeben.
     *
     */
    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();
    
    /*
     * Diese Methode gibt die Ausnahmebedingungsnachricht zurück,
     * die rekursiv mit den Nachrichten aller verschachtelten
     * Ausnahmebedingungen verknüpft ist.
     */
    public String getAllExceptionMessages();
    
    /*
     * Diese Methode gibt den Ausnahmebedingungsstack zurück,
     * der rekursiv mit den Stacks aller verschachtelten
     * Ausnahmebedingungen verknüpft ist.
     */
    public String getAllExceptionStacks();
}

Rechtliche Hinweise |

Letzte Aktualisierung: LASTUPDATEDVAR

(c) Copyright IBM Corporation 2005.
Dieses Information Center basiert auf Eclipse-Technologie. (http://www.eclipse.org)