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
 int getTransactionRemainingTimeout()
          Return duration before current transaction would timeout.
 javax.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

javax.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 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.
SystemException - Thrown if the transaction manager encounters an unexpected error condition.


Copyright © 2005-2015 Oracle Corporation. All Rights Reserved.