Package 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

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      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
      jakarta.xml.ws.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 - jakarta.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

        jakarta.xml.ws.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)