oracle.toplink.jts
Class AbstractSynchronizationListener

java.lang.Object
oracle.toplink.jts.AbstractSynchronizationListener

Direct Known Subclasses:

JTSSynchronizationListener

public abstract class AbstractSynchronizationListener

extends java.lang.Object

Purpose: Abstract Synchronization Listener class Description: This abstract class is paired with AbstractExternalTransactionController. It contains the implementation logic to handle the synchronization callback notifications with respect to UnitOfWork - commiting changes to the database and merging clones into the parent Session. It also provides two abstract methods that must be overridden in any sub-class. The wasTransactionCommited(int) method contains the logic that checks the return status code from the afterCompletion method. Different implementations of OTS/JTS have different returns codes, so this logic must be 'pluggable'. The other method is rollbackGlobalTransaction() which (again) must be overridden to deal with the various different ways to refer to the external global 'Transaction' object and the calls to roll it back. Responsibilities:

• Handle the synchronization callback notifications
• Provide abstract methods to handle Transaction

Field Summary

static boolean

dumpExceptionsFromCallbacks Put in this flag so that if an app server swallows the exception from beforeCompletion or afterCompletion we can dump it out anyway.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

dumpExceptionsFromCallbacks

public static boolean dumpExceptionsFromCallbacks

Put in this flag so that if an app server swallows the exception from beforeCompletion or afterCompletion we can dump it out anyway.