com.sun.xml.ws.tx.at.runtime
Interface TransactionServices

All Known Implementing Classes:
TransactionServicesImpl

public interface TransactionServices

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


Method Summary
 void commit(byte[] tId)
          Called by Participant endpoint to commit tx/subordinate branch
 Xid enlistResource(XAResource resource, Xid xid)
          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
 byte[] getGlobalTransactionId()
          The tx id of the tx on this thread
 EndpointReference getParentReference(Xid xid)
          Called from Participant service to get the Coordinator(PortType) for this Xid
 Xid importTransaction(int timeout, byte[] tId)
          Called by server tube (WSATServerHelper) to infect thread with tx
 String prepare(byte[] tId)
          Called by Participant endpoint to prepare tx/subordinate branch
 void registerSynchronization(Synchronization synchronization, Xid xid)
          Called by Registration service to register a volatile participant
 void replayCompletion(String tId, XAResource xaResource)
          Called by Coordinator replay operation Bottom-up recovery call, as in JTS, a hint to resend
 void rollback(byte[] tId)
          Called by Participant endpoint to prepare tx/subordinate branch
 

Method Detail

getGlobalTransactionId

byte[] getGlobalTransactionId()
The tx id of the tx on this thread

Returns:
byte[] tid

enlistResource

Xid 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

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)


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