com.ibm.websphere.jtaextensions

Interface ExtendedJTATransaction


  1. public interface ExtendedJTATransaction
A WebSphere programming model extension to the J2EE JTA support. An object implementing this interface will be bound, by WebSphere J2EE containers that support this interface, at java:comp/websphere/ExtendedJTATransaction. Access to this object, when called from an EJB container, is not restricted to BMTs.

Method Summary

Modifier and Type Method and Description
  1. byte[]
getGlobalId()
Returns the CosTransactions::PropagationContext::TransIdentity::tid for the transaction currently associated with the calling thread.
  1. int
getLocalId()
Returns a process-unique identifier for the transaction currently associated with the calling thread.
  1. void
registerSynchronizationCallback(SynchronizationCallback sync)
Register a SynchronizationCallback SynchronizationCallback object with the transaction manager.
  1. void
registerSynchronizationCallbackForCurrentTran(SynchronizationCallback sync)
Deprecated. This method is deprecated in favor of registerInterposedSynchronization on javax.transaction.TransactionSynchronizationRegistry.
  1. void
unRegisterSynchronizationCallback(SynchronizationCallback sync)
Unregister a previously registered SynchronizationCallbackobject, sync.

Method Detail

getGlobalId

  1. byte[] getGlobalId()
Returns the CosTransactions::PropagationContext::TransIdentity::tid for the transaction currently associated with the calling thread.
Returns:
the current transaction tid in the form of a byte array. If there is no active transaction currently associated with the thread, returns null;

getLocalId

  1. int getLocalId()
Returns a process-unique identifier for the transaction currently associated with the calling thread. The local-id is valid only within the local process. The local-id is recovered as part of the state of a recovered transaction.
Returns:
an integer that uniquely identifies the current transaction within the calling process. If there is no active transaction currently associated with the thread, returns 0;

registerSynchronizationCallback

  1. void registerSynchronizationCallback( SynchronizationCallback sync)
  2. throws NotSupportedException
Register a SynchronizationCallback SynchronizationCallback object with the transaction manager. The registered sync receives notification of the completion of each transaction mediated by the transaction manager in the local JVM.
Parameters:
sync - An object implementing the SynchronizationCallback interface.
Throws:
NotSupportedException - Thrown if this method is called from an environment or at a time when the function is not available.

registerSynchronizationCallbackForCurrentTran

  1. void registerSynchronizationCallbackForCurrentTran( SynchronizationCallback sync)
  2. throws NotSupportedException
Deprecated. This method is deprecated in favor of registerInterposedSynchronization on javax.transaction.TransactionSynchronizationRegistry.
Register a SynchronizationCallback SynchronizationCallback object for the current transaction. The registered sync receives notification of the completion of the transaction in which it is registered.
Parameters:
sync - An object implementing the SynchronizationCallback interface.
Throws:
NotSupportedException - Thrown if this method is called from an environment or at a time when the function is not available.

unRegisterSynchronizationCallback

  1. void unRegisterSynchronizationCallback( SynchronizationCallback sync)
  2. throws CallbackNotRegisteredException
Unregister a previously registered SynchronizationCallback object, sync. The object so unregistered will receive no further callbacks from transactions that subsequently complete.
Parameters:
sync - A previously registered SynchronizationCallback object.
Throws:
CallbackNotRegisteredException - Thrown if the specific sync is not registered with the transaction manager.