Ausnahmebedingungsbehandlung

Virtual Member Manager meldet die jeweilige Fehlerbedingung in Form einer Ausnahmebedingung an den Aufrufenden.

Virtual Member Manager generiert keine Ereignisse und antwortet nicht auf Benachrichtigungen. Virtual Member Manager protokolliert den jeweiligen Fehler und meldet die Fehlerbedingung in Form einer Ausnahmebedingung, die den Repository-spezifischen Fehlercode und die Repository-Informationen enthält, an den Aufrufenden. In den meisten Fällen werden Ausnahmebedingungen zurück an den Aufrufenden gemeldet. Es werden Unterklassen von "WIMException" erstellt, um verschiedene Arten von Fehlern oder Ausnahmebedingungen zu melden, die in Virtual Member Manager generiert werden. Wenn die betreffende Ausnahmebedingung generiert wird, weil das Repository oder die Registry nicht verfügbar ist, und es einen Wiederholungscode (automatische Wiederherstellung) gibt, wird sie nicht unverzüglich ausgelöst, obwohl sie protokolliert wird. Eine Ausnahmebedingung wird ausgelöst, wenn die Wiederholung fehlschlägt und eine Benutzeraktion zur Behebung des Problems erforderlich ist.

"WIMException" ersetzt "WMMException" und stellt alle Methoden bereit, die zuvor von "WMMException" bereitgestellt wurden. Diese Methoden können von den Adaptern und Providern genutzt werden. Um jedoch die Abwärtskompatibilität sicherzustellen, ist "WIMException" über die WebSphere Member Manager-Brückenfunktion, die "WMMExceptions" in "WIMExceptions" und "WIMExceptions" zurück in "WMMExceptions" umsetzt, mit "WMMException" kompatibel.

Repository-Ausnahmebedingungen

Ausnahmebedingungen, die von den Repositorys ausgelöst werden, können Methoden zum Abrufen des Fehlercodes und/oder der Fehlernachricht enthalten (neben anderen Methoden, die für die jeweilige Ausnahmebedingung spezifisch sind). Adapter verwenden diese Methoden zum Erstellen von "WIMException" oder der zugehörigen Unterklasse sowie zum Definieren der folgenden Informationen:
cause
Gibt eine beliebige vom Repository ausgelöste Ausnahmebedingung oder null an, wenn das Repository keine Ausnahmebedingung generiert hat. Virtual Member Manager verwendet die Funktion für die Ausnahmebedingungsverkettung (Exception Chaining) von JDK 1.4 für die Erstellung der Ausnahmebedingungskette beim Durchlaufen von verschiedenen Komponenten von Virtual Member Manager.
rootErrorCode
Gibt einen Repository-spezifischen ganzzahligen Fehlercode an. Gewöhnlich ist dies der tatsächliche Fehlercode, der vom Repository zurückgegeben wird. Wenn eine Ausnahmebedingung ausgelöst oder eine Fehlernachricht vom Repository zurückgegeben wird, muss der Adapter den Fehlercode von der Ausnahmebedingung abrufen und in der generierten Ausnahmebedingung "WIMException" die eigentliche (Fehler-)Ursache definieren, damit diese für die Analyse des Ausnahmebedingungsproblems in der Trace-Datei protokolliert werden kann. Nachdem der Fehlercode definiert wurde, darf er nicht mehr überschrieben werden.
rootErrorMessage
Gibt eine Repository-spezifische Fehlernachricht an. Gewöhnlich ist dies die tatsächliche Fehlernachricht, der vom Repository zurückgegeben wird. Wenn die Ausnahmebedingung vom Repository ausgelöst wird, muss der Adapter die Fehlernachricht von der Ausnahmebedingung abrufen und in der generierten Ausnahmebedingung "WIMException" die eigentliche (Fehler-)Ursache definieren, damit diese für die Analyse des Ausnahmebedingungsproblems in der Trace-Datei protokolliert werden kann. Nachdem die Fehlernachricht definiert wurde, darf sie nicht mehr überschrieben werden.
rootErrorSource
Gibt eine Zeichenfolge als Repository-Kennung an, die für die eindeutige Kennzeichnung eines Repositorys als Fehlerquelle verwendet wird.
Der Adapter protokolliert in der Protokolldatei von Virtual Member Manager darüber hinaus auch (unter Verwendung von JSR-47-APIs) die Ausnahmebedingung, den Fehlercode und die Fehlernachricht in der ursprünglichen Form. Alle Adapter schreiben ihre Daten in dieselbe Protokolldatei. Wenn die Trace-Erstellung aktiviert ist, kann auch die Fehlernachricht in der Trace-Datei protokolliert werden. Anwendungen können die Ausnahmebedingung in ihren eigenen Protokolldateien protokollieren.

Wenn die Ausnahmebedingung in eine andere Ausnahmebedingung eingeschlossen ist, werden die Werte von "rootErrorCode", "rootErrorMessage" und "rootErrorSource" beim Durchlaufen verschiedener Ebenen in Virtual Member Manager aus der ursprünglichen Ausnahmebedingung kopiert, und "cause" wird als die Ausnahmebedingung definiert, die von der jeweiligen Ebene empfangen wurde.

Der Adapter überträgt die Fehlerbedingung mit Hilfe einer für Virtual Member Manager spezifischen Ausnahmebedingung an Virtual Member Manager, das heißt mit Hilfe von "WIMException" oder der zugehörigen Unterklasse. Der Wert von "WIMException", der von den Adaptern erstellt wird, gibt Methoden für die Definition des Fehlers an, der von den Repositorys zurückgegeben wird. Dadurch werden diese in die Lage versetzt, den Fehlercode und/oder die Fehlernachricht auf niedriger Ebene an den Aufrufenden weiterzugeben.

In einigen Fällen kann das Repository an Stelle des Fehlercodes eine Fehlernachricht oder eine Ausnahmebedingung zurückgeben, die die Fehlernachricht enthält. Die Fehlernachricht ihrerseits kann den Fehlercode enthalten. Der Adapter muss den Fehlercode bzw. die Fehlernachricht extrahieren und in "WIMException" definieren. Alle in Virtual Member Manager definierten Ausnahmebedingungen sind Unterklassen von "WIMException" und können ausnahmebedingungsspezifische Methoden hinzufügen.



Rechtliche Hinweise | Feedback