Welche Möglichkeiten und Funktionen die DLE zur Transaktionsverarbeitung bietet, ist in dem Kapitel über Konnektoren detailliert beschrieben.
Hier werden nur kurz die Methoden der API beschrieben, die diese Funktionalität auf API Ebene anbieten.
Welche Möglichkeiten und Funktionen die DLE zur Transaktionsverarbeitung bietet, ist in dem Kapitel über Konnektoren detailliert beschrieben.
Hier werden nur kurz die Methoden der API beschrieben, die diese Funktionalität auf API Ebene anbieten.
Über die Methoden begin(), commit() und rollback() der API kann der Transaktionsmanager der DLE direkt angewiesen werden eine neue Transaktion zu beginnen, alle offene Transaktionen zu schließen oder abzubrechen.
Im Fehlerfall werfen diese Methoden eine DLETransactionException.
Mit den Methoden addSessionEventListener() können an der DLE Listener registriert werden, die dann von der DLE über Transaktionsereignisse informiert werden.
Mit der Methode removeSessionEventListener() kann ein registrierter Listener wieder deregristiert werden.
Beide Methoden erwarten als Parameter eine Implementierung des Interfaces DLESessionEventListenerIfc, deren Methoden entsprechend dem Ereignis von der DLE aufgerufen werden.
Das Interface definiert folgende Methoden:
| Methode | Beschreibung |
|---|---|
| connectionClosed() | Eine Verbindung wurde geschlossen. |
| connectionErrorOccured() | Ein Verbindungsfehler ist aufgetreten. |
| localTransactionStarted() | Eine Transaktion wurde durch den Transaktionsmanager gestartet. |
| localTransactionCommited() | Eine Transaktion wurde durch den Transaktionsmanager abgeschlossen. |
| localTransactionRolledback() | Eine Transaktion wurde durch den Transaktionsmanager abgebrochen. |
Alle Methoden erhalten als Parameter ein DLESessionEvent. Dieses ist eine Erweiterung der java.util.EventObject Klasse. Source des EventObject ist dabei immer die DLEsession Instanz.