FileDocCategorySizeDatePackage
Transaction.javaAPI DocGlassfish v2 API7953Fri May 04 22:35:24 BST 2007javax.transaction

Transaction

public interface Transaction
The Transaction interface allows operations to be performed against the transaction in the target Transaction object. A Transaction object is created corresponding to each global transaction creation. The Transaction object can be used for resource enlistment, synchronization registration, transaction completion, and status query operations.

Fields Summary
Constructors Summary
Methods Summary
public voidcommit()
Complete the transaction represented by this Transaction object.

exception
RollbackException Thrown to indicate that the transaction has been rolled back rather than committed.
exception
HeuristicMixedException Thrown to indicate that a heuristic decision was made and that some relevant updates have been committed while others have been rolled back.
exception
HeuristicRollbackException Thrown to indicate that a heuristic decision was made and that all relevant updates have been rolled back.
exception
SecurityException Thrown to indicate that the thread is not allowed to commit the transaction.
exception
IllegalStateException Thrown if the transaction in the target object is inactive.
exception
SystemException Thrown if the transaction manager encounters an unexpected error condition.

public booleandelistResource(javax.transaction.xa.XAResource xaRes, int flag)
Disassociate the resource specified from the transaction associated with the target Transaction object.

param
xaRes The XAResource object associated with the resource (connection).
param
flag One of the values of TMSUCCESS, TMSUSPEND, or TMFAIL.
exception
IllegalStateException Thrown if the transaction in the target object is inactive.
exception
SystemException Thrown if the transaction manager encounters an unexpected error condition.
return
true if the resource was delisted successfully; otherwise false.

public booleanenlistResource(javax.transaction.xa.XAResource xaRes)
Enlist the resource specified with the transaction associated with the target Transaction object.

param
xaRes The XAResource object associated with the resource (connection).
return
true if the resource was enlisted successfully; otherwise false.
exception
RollbackException Thrown to indicate that the transaction has been marked for rollback only.
exception
IllegalStateException Thrown if the transaction in the target object is in the prepared state or the transaction is inactive.
exception
SystemException Thrown if the transaction manager encounters an unexpected error condition.

public intgetStatus()
Obtain the status of the transaction associated with the target Transaction object.

return
The transaction status. If no transaction is associated with the target object, this method returns the Status.NoTransaction value.
exception
SystemException Thrown if the transaction manager encounters an unexpected error condition.

public voidregisterSynchronization(javax.transaction.Synchronization sync)
Register a synchronization object for the transaction currently associated with the target object. The transction manager invokes the beforeCompletion method prior to starting the two-phase transaction commit process. After the transaction is completed, the transaction manager invokes the afterCompletion method.

param
sync The Synchronization object for the transaction associated with the target object.
exception
RollbackException Thrown to indicate that the transaction has been marked for rollback only.
exception
IllegalStateException Thrown if the transaction in the target object is in the prepared state or the transaction is inactive.
exception
SystemException Thrown if the transaction manager encounters an unexpected error condition.

public voidrollback()
Rollback the transaction represented by this Transaction object.

exception
IllegalStateException Thrown if the transaction in the target object is in the prepared state or the transaction is inactive.
exception
SystemException Thrown if the transaction manager encounters an unexpected error condition.

public voidsetRollbackOnly()
Modify the transaction associated with the target object such that the only possible outcome of the transaction is to roll back the transaction.

exception
IllegalStateException Thrown if the target object is not associated with any transaction.
exception
SystemException Thrown if the transaction manager encounters an unexpected error condition.