Package com.sun.xml.ws.tx.at.common

Interface TransactionImportWrapper

All Known Implementing Classes:

TransactionImportManager

public interface TransactionImportWrapper

Duplicates GF Transaction Manager extensions interface TransactionImport that support transaction inflow w/o resource adapter.

Author:

Marek Potociar

Method Summary

Modifier and Type	Method	Description
int	getTransactionRemainingTimeout()	Return duration before current transaction would timeout.
jakarta.resource.spi.XATerminator	getXATerminator()	Provides a handle to a XATerminator instance which is used to import an external transaction into Java EE TM.
void	recreate(Xid xid, long timeout)	Recreate a transaction based on the Xid.
void	release(Xid xid)	Release a transaction.

Method Detail

recreate

void recreate(Xid xid,
              long timeout)

Recreate a transaction based on the Xid. This call causes the calling thread to be associated with the specified transaction.

This method imports a transactional context controlled by an external transaction manager.

Parameters:

xid - the Xid object representing a transaction.

release

void release(Xid xid)

Release a transaction. This call causes the calling thread to be dissociated from the specified transaction.

This call releases transactional context imported by recreate method.

Parameters:

xid - the Xid object representing a transaction.

getXATerminator

jakarta.resource.spi.XATerminator getXATerminator()

Provides a handle to a XATerminator instance which is used to import an external transaction into Java EE TM.

The XATerminator exports 2PC protocol control to an external root transaction coordinator.

Returns:

a XATerminator instance.

getTransactionRemainingTimeout

int getTransactionRemainingTimeout()
                            throws jakarta.transaction.SystemException

Return duration before current transaction would timeout.

Returns:

Returns the duration in seconds before current transaction would timeout. Returns zero if transaction has no timeout set or if any exceptions occured while looking up remaining transaction timeout. Returns negative value if transaction already timed out.

Throws:

IllegalStateException - Thrown if the current thread is not associated with a transaction.

jakarta.transaction.SystemException - Thrown if the transaction manager encounters an unexpected error condition.