|
J2EE1.4 SDK | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
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 |
public 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.
java.lang.SecurityException - Thrown to indicate that the thread is
not allowed to commit the transaction.
java.lang.IllegalStateException - Thrown if the transaction in the
target object is inactive.
SystemException - Thrown if the transaction manager
encounters an unexpected error condition.
public 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.
java.lang.IllegalStateException - Thrown if the transaction in the
target object is inactive.
SystemException - Thrown if the transaction manager
encounters an unexpected error condition.
public 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.
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.
public int getStatus()
throws SystemException
SystemException - Thrown if the transaction manager
encounters an unexpected error condition.
public 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.
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.
public void rollback()
throws java.lang.IllegalStateException,
SystemException
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.
public void setRollbackOnly()
throws java.lang.IllegalStateException,
SystemException
java.lang.IllegalStateException - Thrown if the target object is
not associated with any transaction.
SystemException - Thrown if the transaction manager
encounters an unexpected error condition.
|
J2EE1.4 SDK | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Copyright 2003 Sun Microsystems, Inc. All rights reserved.