| 
 | 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.