org.jboss.proxy.ejb
Class ForeignTransaction

java.lang.Object
  org.jboss.proxy.ejb.ForeignTransaction

All Implemented Interfaces:

Transaction (src)

public class ForeignTransaction

extends java.lang.Object

implements Transaction (src)

A ForeignTransaction, a marker for when we would have to import a transaction from another vendor. Which we don't do at the moment.

instance

public static final ForeignTransaction (src)  instance

commit

public void commit()
            throws RollbackException (src) ,
                   HeuristicMixedException (src) ,
                   HeuristicRollbackException (src) ,
                   java.lang.SecurityException,
                   SystemException (src) 

Description copied from interface: Transaction (src)

Attempt to commit this transaction.

Specified by:

commit in interface Transaction (src)

Throws:

java.lang.SecurityException - If the caller is not allowed to commit this transaction.

SystemException (src) - If the transaction service fails in an unexpected way.

RollbackException (src) - If the transaction was marked for rollback only, the transaction is rolled back and this exception is thrown.

HeuristicMixedException (src) - If a heuristic decision was made and some some parts of the transaction have been committed while other parts have been rolled back.

HeuristicRollbackException (src) - If a heuristic decision to roll back the transaction was made.

rollback

public void rollback()
              throws java.lang.IllegalStateException,
                     SystemException (src) 

Description copied from interface: Transaction (src)

Rolls back this transaction.

Specified by:

rollback in interface Transaction (src)

Throws:

java.lang.IllegalStateException - If the transaction is in a state where it cannot be rolled back. This could be because the transaction is no longer active, or because it is in the prepared state.

SystemException (src) - If the transaction service fails in an unexpected way.

setRollbackOnly

public void setRollbackOnly()
                     throws java.lang.IllegalStateException,
                            SystemException (src) 

Description copied from interface: Transaction (src)

Mark the transaction so that the only possible outcome is a rollback.

Specified by:

setRollbackOnly in interface Transaction (src)

Throws:

SystemException (src) - If the transaction service fails in an unexpected way.

java.lang.IllegalStateException - If the transaction is not in an active state.

getStatus

public int getStatus()
              throws SystemException (src) 

Description copied from interface: Transaction (src)

Get the status of the transaction.

Specified by:

getStatus in interface Transaction (src)

Returns:

The status of the transaction. This is one of the Status (src) constants.

Throws:

SystemException (src) - If the transaction service fails in an unexpected way.

enlistResource

public boolean enlistResource(XAResource (src)  xaRes)
                       throws RollbackException (src) ,
                              java.lang.IllegalStateException,
                              SystemException (src) 

Description copied from interface: Transaction (src)

Enlist an XA resource with this transaction.

Specified by:

enlistResource in interface Transaction (src)

Returns:

true if the resource could be enlisted with this transaction, otherwise false.

Throws:

SystemException (src) - If the transaction service fails in an unexpected way.

RollbackException (src) - If the transaction is marked for rollback only.

java.lang.IllegalStateException - If the transaction is in a state where resources cannot be enlisted. This could be because the transaction is no longer active, or because it is in the prepared state.

delistResource

public boolean delistResource(XAResource (src)  xaRes,
                              int flag)
                       throws java.lang.IllegalStateException,
                              SystemException (src) 

Description copied from interface: Transaction (src)

Delist an XA resource from this transaction.

Specified by:

delistResource in interface Transaction (src)

Returns:

true if the resource could be delisted from this transaction, otherwise false.

Throws:

java.lang.IllegalStateException - If the transaction is in a state where resources cannot be delisted. This could be because the transaction is no longer active.

SystemException (src) - If the transaction service fails in an unexpected way.

registerSynchronization

public void registerSynchronization(Synchronization (src)  sync)
                             throws RollbackException (src) ,
                                    java.lang.IllegalStateException,
                                    SystemException (src) 

Description copied from interface: Transaction (src)

Register a Synchronization (src) callback with this transaction.

Specified by:

registerSynchronization in interface Transaction (src)

Throws:

RollbackException (src) - If the transaction is marked for rollback only.

SystemException (src) - If the transaction service fails in an unexpected way.

java.lang.IllegalStateException - If the transaction is in a state where Synchronization (src) callbacks cannot be registered. This could be because the transaction is no longer active, or because it is in the prepared state.