UserTransaction (JBoss J2EE API) - JBoss 4.0.1 sp1 j2ee API Documentation 英文版文档

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.transaction
Interface UserTransaction

public interface UserTransaction

This interface allows an application to explicitly manage transactions.

Version:: $Revision: 1.3 $

Method Summary

void begin()
          Starts a new transaction, and associate it with the calling thread.

void commit()
          Commit the transaction associated with the calling thread.

int getStatus()
          Get the status of the transaction associated with the calling thread.

void rollback()
          Rolls back the transaction associated with the calling thread.

void setRollbackOnly()
          Mark the transaction associated with the calling thread for rollback only.

void setTransactionTimeout(int seconds)
          Change the transaction timeout for transactions started by the calling thread with the begin() method.

Method Detail

begin

public void begin()
           throws NotSupportedException,
                  SystemException

Starts a new transaction, and associate it with the calling thread.

Throws:: NotSupportedException - If the calling thread is already associated with a transaction, and nested transactions are not supported.; SystemException - If the transaction service fails in an unexpected way.

commit

public void commit()
            throws RollbackException,
                   HeuristicMixedException,
                   HeuristicRollbackException,
                   SecurityException,
                   IllegalStateException,
                   SystemException

Commit the transaction associated with the calling thread.

Throws:: RollbackException - If the transaction was marked for rollback only, the transaction is rolled back and this exception is thrown.; IllegalStateException - If the calling thread is not associated with a transaction.; SystemException - If the transaction service fails in an unexpected way.; HeuristicMixedException - If a heuristic decision was made and some some parts of the transaction have been committed while other parts have been rolled back.; HeuristicRollbackException - If a heuristic decision to roll back the transaction was made.; SecurityException - If the caller is not allowed to commit this transaction.

rollback

public void rollback()
              throws IllegalStateException,
                     SecurityException,
                     SystemException

Rolls back the transaction associated with the calling thread.

Throws:: IllegalStateException - If the transaction is in a state where it cannot be rolled back. This could be because the calling thread is not associated with a transaction, or because it is in the prepared state.; SecurityException - If the caller is not allowed to roll back this transaction.; SystemException - If the transaction service fails in an unexpected way.

setRollbackOnly

public void setRollbackOnly()
                     throws IllegalStateException,
                            SystemException

Mark the transaction associated with the calling thread for rollback only.

Throws:: IllegalStateException - If the transaction is in a state where it cannot be rolled back. This could be because the calling thread is not associated with a transaction, or because it is in the prepared state.; SystemException - If the transaction service fails in an unexpected way.

getStatus

public int getStatus()
              throws SystemException

Get the status of the transaction associated with the calling thread.

Returns:: The status of the transaction. This is one of the Status constants. If no transaction is associated with the calling thread, Status.STATUS_NO_TRANSACTION is returned.
Throws:: SystemException - If the transaction service fails in an unexpected way.

setTransactionTimeout

public void setTransactionTimeout(int seconds)
                           throws SystemException

Change the transaction timeout for transactions started by the calling thread with the begin() method.

Parameters:: seconds - The new timeout value, in seconds. If this parameter is 0, the timeout value is reset to the default value.
Throws:: SystemException - If the transaction service fails in an unexpected way.