javax.transaction.UserTransaction翻译

<!-- ========= START OF TOP NAVBAR ======= --> <!-- -->

<!-- --> Overview Package Class Tree Deprecated Index Help	JavaTM 2 Platform Ent. Ed. v1.4
PREV CLASS NEXT CLASS	FRAMES NO FRAMES <!-- if(window==top) { document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>'); } //--> All Classes <noscript></noscript>
SUMMARY:NESTED|FIELD|CONSTR|METHOD	DETAIL:FIELD|CONSTR|METHOD

<!-- ========= END OF TOP NAVBAR ========= -->

---

<!-- ======== START OF CLASS DATA ======== -->

javax.transaction
Interface UserTransaction

---

public interface UserTransaction

The UserTransaction interface defines the methods that allow an application to explicitly manage transaction boundaries. UserTransaction接口定义了一些方法，以允许应用明确管理事务的界线。

---

<!-- ======== NESTED CLASS SUMMARY ======== --><!-- =========== FIELD SUMMARY =========== --><!-- ======== CONSTRUCTOR SUMMARY ======== --><!-- ========== METHOD SUMMARY =========== --><!-- -->

Method Summary
void	begin() Create a new transaction and associate it with the current thread. 创建一个新事物并与当前线程关联。
void	commit() Complete the transaction associated with the current thread. 完成与当前线程关联的事务。
int	getStatus() Obtain the status of the transaction associated with the current thread. 获取与当前线程关联事务的状态。
void	rollback() Roll back the transaction associated with the current thread. 回滚与当前线程关联的事务。
void	setRollbackOnly() Modify the transaction associated with the current thread such that the only possible outcome of the transaction is to roll back the transaction. 修改当前线程的关联事务，使得事务的唯一可能结果是回滚该事务。
void	setTransactionTimeout(intseconds) Modify the timeout value that is associated with transactions started by subsequent invocations of the begin method. 修改随后使用begin方法调用开始的事务超时值。

<!-- ============ FIELD DETAIL =========== --><!-- ========= CONSTRUCTOR DETAIL ======== --><!-- ============ METHOD DETAIL ========== --><!-- -->

Method Detail

<!-- -->

begin

public void begin()
           throws NotSupportedException,
                  SystemException

Create a new transaction and associate it with the current thread. 创建一个新事物并与当前线程关联。

Throws:

NotSupportedException - Thrown if the thread is already associated with a transaction and the Transaction Manager implementation does not support nested transactions. 当线程已经与事务关联，事务管理器的实现不支持嵌套事务时抛出。

SystemException - Thrown if the transaction manager encounters an unexpected error condition. 如果事务管理器遭遇无法预料错误的情况时抛出。

---

<!-- -->

commit

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

Complete the transaction associated with the current thread. When this method completes, the thread is no longer associated with a transaction. 完成与当前线程关联的事务。方法完成后，线程不再与事务关联。

Throws:

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 current thread is not associated with a transaction. 如果当前线程没有和事务关联时抛出。

SystemException - Thrown if the transaction manager encounters an unexpected error condition. 如果事务管理器遭遇无法预料错误的情况时抛出。

---

<!-- -->

rollback

public void rollback()
              throws IllegalStateException,
                     SecurityException,
                     SystemException

Roll back the transaction associated with the current thread. When this method completes, the thread is no longer associated with a transaction. 回滚与当前线程关联的事务。方法完成后，线程不再与事务关联。

Throws:

SecurityException - Thrown to indicate that the thread is not allowed to roll back the transaction. 抛出表示当前线程不允许回滚事务。

IllegalStateException - Thrown if the current thread is not associated with a transaction. 如果当前线程没有和事务关联时抛出。

SystemException - Thrown if the transaction manager encounters an unexpected error condition. 如果事务管理器遭遇无法预料错误的情况时抛出。

---

<!-- -->

setRollbackOnly

public void setRollbackOnly()
                     throws IllegalStateException,
                            SystemException

Modify the transaction associated with the current thread such that the only possible outcome of the transaction is to roll back the transaction. 修改当前线程的关联事务，使得事务的唯一可能结果是回滚该事务。

Throws:

IllegalStateException - Thrown if the current thread is not associated with a transaction. 如果当前线程没有和事务关联时抛出。

SystemException - Thrown if the transaction manager encounters an unexpected error condition. 如果事务管理器遭遇无法预料错误的情况时抛出。

---

<!-- -->

getStatus

public int getStatus()
              throws SystemException

Obtain the status of the transaction associated with the current thread. 获取与当前线程关联事务的状态。

Returns:

The transaction status. If no transaction is associated with the current thread, this method returns the Status.NoTransaction value. 事务状态。如果当前线程没有关联事务，方法返回Status.NoTransaction值。

Throws:

SystemException - Thrown if the transaction manager encounters an unexpected error condition. 如果事务管理器遭遇无法预料错误的情况时抛出。

---

<!-- -->

setTransactionTimeout

public void setTransactionTimeout(intseconds)
                           throws SystemException

Modify the timeout value that is associated with transactions started by subsequent invocations of the begin method. 修改随后使用begin方法调用开始的事务超时值。

If an application has not called this method, the transaction service uses some default value for the transaction timeout. 如果应用没有调用该方法，事务服务将使用事务超时的默认值。

Parameters:

seconds - The value of the timeout in seconds. If the value is zero, the transaction service restores the default value. If the value is negative a SystemException is thrown. 以秒为单位的超时值。如果值为0，事务服务恢复为初始值。如果值为负，抛出SystemException。

Throws:

SystemException - Thrown if the transaction manager encounters an unexpected error condition. 如果事务管理器遭遇无法预料错误的情况时抛出。

<!-- ========= END OF CLASS DATA ========= -->

---

<!-- ======= START OF BOTTOM NAVBAR ====== --> <!-- -->

<!-- --> Overview Package Class Tree Deprecated Index Help	JavaTM 2 Platform Ent. Ed. v1.4
PREV CLASS NEXT CLASS	FRAMES NO FRAMES <!-- if(window==top) { document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>'); } //--> All Classes <noscript></noscript>
SUMMARY:NESTED|FIELD|CONSTR|METHOD	DETAIL:FIELD|CONSTR|METHOD

<!-- ======== END OF BOTTOM NAVBAR ======= -->

---

Submit a bug or feature

Copyright 2003 Sun Microsystems, Inc. All rights reserved.