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

Class TransactionManagerImpl

    • Method Detail

      • isTransactionManagerAvailable

        public boolean isTransactionManagerAvailable()

      • getStatus

        public int getStatus()
              throws SystemException
        Description copied from interface: TransactionManager
        Obtain the status of the transaction associated with the current thread.
        Specified by:
        getStatus in interface TransactionManager
        Returns:
        The transaction status. If no transaction is associated with the current thread, this method returns the Status.NoTransaction value.
        Throws:
        SystemException - Thrown if the transaction manager encounters an unexpected error condition.

      • getTransaction

        public Transaction getTransaction()
                           throws SystemException
        Description copied from interface: TransactionManager
        Get the transaction object that represents the transaction context of the calling thread.
        Specified by:
        getTransaction in interface TransactionManager
        Returns:
        the Transaction object representing the transaction associated with the calling thread.
        Throws:
        SystemException - Thrown if the transaction manager encounters an unexpected error condition.

      • setTransactionTimeout

        public void setTransactionTimeout​(int seconds)
                           throws SystemException
        Description copied from interface: TransactionManager
        Modify the timeout value that is associated with transactions started by the current thread with the begin method.

        If an application has not called this method, the transaction service uses some default value for the transaction timeout.

        Specified by:
        setTransactionTimeout in interface TransactionManager
        Parameters:
        seconds - The value of the timeout in seconds. If the value is zero, the transaction service restores the default value. If the value is negative a SystemException is thrown.
        Throws:
        SystemException - Thrown if the transaction manager encounters an unexpected error condition.

      • suspend

        public Transaction suspend()
                    throws SystemException
        Description copied from interface: TransactionManager
        Suspend the transaction currently associated with the calling thread and return a Transaction object that represents the transaction context being suspended. If the calling thread is not associated with a transaction, the method returns a null object reference. When this method returns, the calling thread is not associated with a transaction.
        Specified by:
        suspend in interface TransactionManager
        Returns:
        Transaction object representing the suspended transaction.
        Throws:
        SystemException - Thrown if the transaction manager encounters an unexpected error condition.

      • getTransactionKey

        public Object getTransactionKey()
        Description copied from interface: TransactionSynchronizationRegistry
        Return an opaque object to represent the transaction bound to the current thread at the time this method is called. This object overrides hashCode and equals to allow its use as the key in a hashMap for use by the caller. If there is no transaction currently active, return null.

        This object will return the same hashCode and compare equal to all other objects returned by calling this method from any component executing in the same transaction context in the same application server.

        The toString method returns a String that might be usable by a human reader to usefully understand the transaction context. The toString result is otherwise not defined. Specifically, there is no forward or backward compatibility guarantee of the results of toString.

        The object is not necessarily serializable, and has no defined behavior outside the virtual machine whence it was obtained.

        Specified by:
        getTransactionKey in interface TransactionSynchronizationRegistry
        Returns:
        an opaque object representing the transaction bound to the current thread at the time this method is called.

      • putResource

        public void putResource​(Object object,
                        Object object0)
        Description copied from interface: TransactionSynchronizationRegistry
        Add or replace an object in the Map of resources being managed for the transaction bound to the current thread at the time this method is called. The supplied key should be of an caller- defined class so as not to conflict with other users. The class of the key must guarantee that the hashCode and equals methods are suitable for use as keys in a map. The key and value are not examined or used by the implementation. The general contract of this method is that of Map.put(Object, Object) for a Map that supports non-null keys and null values. For example, if there is already an value associated with the key, it is replaced by the value parameter.
        Specified by:
        putResource in interface TransactionSynchronizationRegistry
        Parameters:
        object - the key for the Map entry.
        object0 - the value for the Map entry.

      • getResource

        public Object getResource​(Object object)
        Description copied from interface: TransactionSynchronizationRegistry
        Get an object from the Map of resources being managed for the transaction bound to the current thread at the time this method is called. The key should have been supplied earlier by a call to putResouce in the same transaction. If the key cannot be found in the current resource Map, null is returned. The general contract of this method is that of Map.get(Object) for a Map that supports non-null keys and null values. For example, the returned value is null if there is no entry for the parameter key or if the value associated with the key is actually null.
        Specified by:
        getResource in interface TransactionSynchronizationRegistry
        Parameters:
        object - the key for the Map entry.
        Returns:
        the value associated with the key.

      • registerInterposedSynchronization

        public void registerInterposedSynchronization​(Synchronization synchronization)
        Description copied from interface: TransactionSynchronizationRegistry
        Register a Synchronization instance with special ordering semantics. Its beforeCompletion will be called after all SessionSynchronization beforeCompletion callbacks and callbacks registered directly with the Transaction, but before the 2-phase commit process starts. Similarly, the afterCompletion callback will be called after 2-phase commit completes but before any SessionSynchronization and Transaction afterCompletion callbacks.

        The beforeCompletion callback will be invoked in the transaction context of the transaction bound to the current thread at the time this method is called. Allowable methods include access to resources, e.g. Connectors. No access is allowed to "user components" (e.g. timer services or bean methods), as these might change the state of data being managed by the caller, and might change the state of data that has already been flushed by another caller of registerInterposedSynchronization. The general context is the component context of the caller of registerInterposedSynchronization.

        The afterCompletion callback will be invoked in an undefined context. No access is permitted to "user components" as defined above. Resources can be closed but no transactional work can be performed with them.

        If this method is invoked without an active transaction context, an IllegalStateException is thrown.

        If this method is invoked after the two-phase commit processing has started, an IllegalStateException is thrown.

        Specified by:
        registerInterposedSynchronization in interface TransactionSynchronizationRegistry
        Parameters:
        synchronization - the Synchronization instance.

      • registerSynchronization

        public void registerSynchronization​(Synchronization sync)

      • getTransactionStatus

        public int getTransactionStatus()
        Description copied from interface: TransactionSynchronizationRegistry
        Return the status of the transaction bound to the current thread at the time this method is called. This is the result of executing TransactionManager.getStatus() in the context of the transaction bound to the current thread at the time this method is called.
        Specified by:
        getTransactionStatus in interface TransactionSynchronizationRegistry
        Returns:
        the status of the transaction bound to the current thread at the time this method is called.

      • servletPreInvokeTx

        public void servletPreInvokeTx()
        PreInvoke Transaction configuration for Servlet Container. BaseContainer.preInvokeTx() handles all this for CMT EJB. Compensate that J2EEInstanceListener.handleBeforeEvent(BEFORE_SERVICE_EVENT) gets called before WSIT WSTX Service pipe associates a JTA txn with incoming thread. Precondition: assumes JTA transaction already associated with current thread. Note: this method is a no-op when invoked on an EJB.

      • servletPostInvokeTx

        public void servletPostInvokeTx​(Boolean suspend)
        PostInvoke Transaction configuration for Servlet Container. BaseContainer.preInvokeTx() handles all this for CMT EJB. Precondition: assumed called prior to current transcation being suspended or released. Note: this method is a no-op when invoked on an EJB. The J2EE method only has an effect on servlets.
        Parameters:
        suspend - indicate whether the delisting is due to suspension or transaction completion(commmit/rollback)

      • getRemainingTimeout

        public int getRemainingTimeout()
        Returns in seconds duration till current transaction times out. Returns negative value if transaction has already timedout. Returns 0 if there is no timeout. Returns 0 if any exceptions occur looking up remaining transaction timeout.