weblogic.wsee.wstx
Interface TransactionServices

public interface TransactionServices

Defines the interface between WS-AT and underlying transaction processing system

getGlobalTransactionId

byte[] getGlobalTransactionId()

The tx id of the tx on this thread

Returns:

byte[] tid

enlistResource

byte[] enlistResource(XAResource resource,
                      Xid xid)
                      throws WSATException

Called by Registraion Service during register call in order to enlist WSAT XAResource (this is essentially the WSAT participant EPR wrapper that is serialized for recovery) and return branchqual in order to create RegisterResponseType

Parameters:

resource - (WSAT)XAResource

xid - Xid

Returns:

byte[] branchqual to use for

Throws:

WSATException - any error during enlist as WSAT GatewayRM

registerSynchronization

void registerSynchronization(Synchronization synchronization,
                             Xid xid)
                             throws WSATException

Called by Registration service to register a volatile participant

Parameters:

synchronization - javax.transaction.Synchronization

xid - Xid

Throws:

WSATException - wsatXAResource

getExpires

int getExpires()

The tx timeout/ttl value

Returns:

int seconds

importTransaction

Xid importTransaction(int timeout,
                      byte[] tId)
                      throws WSATException

Called by server tube (WSATServerHelper) to infect thread with tx

Parameters:

timeout - timeout/ttl

tId - byte[]

Throws:

WSATException - wsatXAResource

prepare

String prepare(byte[] tId)
               throws WSATException

Called by Participant endpoint to prepare tx/subordinate branch

Parameters:

tId - byte[]

Returns:

String vote, see WSATConstants

Throws:

WSATException - wsatXAResource

commit

void commit(byte[] tId)
            throws WSATException

Called by Participant endpoint to commit tx/subordinate branch

Parameters:

tId - byte[]

Throws:

WSATException - wsatXAResource

rollback

void rollback(byte[] tId)
              throws WSATException

Called by Participant endpoint to prepare tx/subordinate branch

Parameters:

tId - byte[]

Throws:

WSATException - wsatXAResource

replayCompletion

void replayCompletion(String tId,
                      XAResource xaResource)
                      throws WSATException

Called by Coordinator replay operation Bottom-up recovery call, as in JTS, a hint to resend

Parameters:

tId - byte[]

xaResource - (WSAT)XAResource

Throws:

WSATException - wsatXAResource

getParentReference

EndpointReference getParentReference(Xid xid)

Called from Participant service to get the Coordinator(PortType) for this Xid

Parameters:

xid - Xid

Returns:

EndpointReference of Coordinator (as obtained from earlier RegisterResponse)