javax.transaction
Interface Transaction

All Known Implementing Classes:

DummyTransaction (src) , ForeignTransaction (src) , TransactionImpl (src)

public interface Transaction

The Transaction interface allows operations to be performed on transactions.

commit

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

Attempt to commit this transaction.

Throws:

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

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

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.

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

rollback

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

Rolls back this transaction.

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) 

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

Throws:

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

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

getStatus

public int getStatus()
              throws SystemException (src) 

Get the status of the transaction.

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) 

Enlist an XA resource with this transaction.

Returns:

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

Throws:

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.

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

delistResource

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

Delist an XA resource from this transaction.

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) 

Register a Synchronization (src) callback with this transaction.

Throws:

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

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.

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