package javax.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.
Complete the transaction represented by this Transaction object.
Disassociate the resource specified from the transaction associated
with the target Transaction object.
- Parameters:
xaRes The XAResource object associated with the resource
(connection).flag One of the values of TMSUCCESS, TMSUSPEND, or TMFAIL.- Returns:
- true if the resource was delisted successfully; otherwise
false.
- Throws:
java.lang.IllegalStateException Thrown if the transaction in the
target object is inactive.SystemException Thrown if the transaction manager
encounters an unexpected error condition.
Enlist the resource specified with the transaction associated with the
target Transaction object.
- Parameters:
xaRes The XAResource object associated with the resource
(connection).- Returns:
- true if the resource was enlisted successfully; otherwise
false.
- Throws:
RollbackException Thrown to indicate that
the transaction has been marked for rollback only.java.lang.IllegalStateException Thrown if the transaction in the
target object is in the prepared state or the transaction is
inactive.SystemException Thrown if the transaction manager
encounters an unexpected error condition.
Obtain the status of the transaction associated with the target
Transaction object.
- Returns:
- The transaction status. If no transaction is associated with
the target object, this method returns the
Status.NoTransaction value.
- Throws:
SystemException Thrown if the transaction manager
encounters an unexpected error condition.
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.
- Parameters:
sync The Synchronization object for the transaction associated
with the target object.- Throws:
RollbackException Thrown to indicate that
the transaction has been marked for rollback only.java.lang.IllegalStateException Thrown if the transaction in the
target object is in the prepared state or the transaction is
inactive.SystemException Thrown if the transaction manager
encounters an unexpected error condition.
Rollback the transaction represented by this Transaction object.
- Throws:
java.lang.IllegalStateException Thrown if the transaction in the
target object is in the prepared state or the transaction is
inactive.SystemException Thrown if the transaction manager
encounters an unexpected error condition.
Modify the transaction associated with the target object such that
the only possible outcome of the transaction is to roll back the
transaction.