|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
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.
Method Summary | |
---|---|
void |
commit()
Complete the transaction represented by this Transaction object. |
boolean |
delistResource(XAResource xaRes,
int flag)
Disassociate the resource specified from the transaction associated with the target Transaction object. |
boolean |
enlistResource(XAResource xaRes)
Enlist the resource specified with the transaction associated with the target Transaction object. |
int |
getStatus()
Obtain the status of the transaction associated with the target Transaction object. |
void |
registerSynchronization(Synchronization sync)
Register a synchronization object for the transaction currently associated with the target object. |
void |
rollback()
Rollback the transaction represented by this Transaction object. |
void |
setRollbackOnly()
Modify the transaction associated with the target object such that the only possible outcome of the transaction is to roll back the transaction. |
Method Detail |
---|
void commit() throws RollbackException, HeuristicMixedException, HeuristicRollbackException, java.lang.SecurityException, java.lang.IllegalStateException, SystemException
RollbackException
- Thrown to indicate that
the transaction has been rolled back rather than committed.
HeuristicMixedException
- Thrown to indicate that a heuristic
decision was made and that some relevant updates have been committed
while others have been rolled back.
HeuristicRollbackException
- Thrown to indicate that a
heuristic decision was made and that all relevant updates have been
rolled back.
SecurityException
- Thrown to indicate that the thread is
not allowed to commit the transaction.
IllegalStateException
- Thrown if the transaction in the
target object is inactive.
SystemException
- Thrown if the transaction manager
encounters an unexpected error condition.boolean delistResource(XAResource xaRes, int flag) throws java.lang.IllegalStateException, SystemException
xaRes
- The XAResource object associated with the resource
(connection).flag
- One of the values of TMSUCCESS, TMSUSPEND, or TMFAIL.
IllegalStateException
- Thrown if the transaction in the
target object is inactive.
SystemException
- Thrown if the transaction manager
encounters an unexpected error condition.boolean enlistResource(XAResource xaRes) throws RollbackException, java.lang.IllegalStateException, SystemException
xaRes
- The XAResource object associated with the resource
(connection).
RollbackException
- Thrown to indicate that
the transaction has been marked for rollback only.
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.int getStatus() throws SystemException
SystemException
- Thrown if the transaction manager
encounters an unexpected error condition.void registerSynchronization(Synchronization sync) throws RollbackException, java.lang.IllegalStateException, SystemException
sync
- The Synchronization object for the transaction associated
with the target object.
RollbackException
- Thrown to indicate that
the transaction has been marked for rollback only.
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.void rollback() throws java.lang.IllegalStateException, SystemException
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.void setRollbackOnly() throws java.lang.IllegalStateException, SystemException
IllegalStateException
- Thrown if the target object is
not associated with any transaction.
SystemException
- Thrown if the transaction manager
encounters an unexpected error condition.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 2009-2011, Oracle Corporation and/or its affiliates. All Rights Reserved. Use is subject to license terms.
Generated on 10-February-2011 12:41