GrepCode: javax.transaction.UserTransaction (.java) - Interface

Maven-Central
/
javax.transaction / jta
/
1.1
/
javax.transaction.UserTransaction
Find Usages
Raw
Download
HTML Widget
Stack Overflow Questions
1
  /*
2
   * The contents of this file are subject to the terms 
3
   * of the Common Development and Distribution License 
4
   * (the License).  You may not use this file except in
5
   * compliance with the License.
6
   * 
7
   * You can obtain a copy of the license at 
8
   * https://glassfish.dev.java.net/public/CDDLv1.0.html or
9
   * glassfish/bootstrap/legal/CDDLv1.0.txt.
10
  * See the License for the specific language governing 
11
  * permissions and limitations under the License.
12
  * 
13
  * When distributing Covered Code, include this CDDL 
14
  * Header Notice in each file and include the License file 
15
  * at glassfish/bootstrap/legal/CDDLv1.0.txt.  
16
  * If applicable, add the following below the CDDL Header, 
17
  * with the fields enclosed by brackets [] replaced by
18
  * you own identifying information: 
19
  * "Portions Copyrighted [year] [name of copyright owner]"
20
  * 
21
  * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
22
  */
23
 
24
 package javax.transaction;
25
 
26
 import java.lang.IllegalArgumentException;
27
 import java.lang.IllegalStateException;
28
 import java.lang.SecurityException;

 The UserTransaction interface defines the methods that allow an
 application to explicitly manage transaction boundaries.
33
 
34
 public interface UserTransaction {

    
 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.
46
 
47
     void begin() throws NotSupportedException, 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.java.lang.SecurityException Thrown to indicate that the thread is
    not allowed to commit the transaction.java.lang.IllegalStateException Thrown if the current thread is
    not associated with a transaction.SystemException Thrown if the transaction manager
    encounters an unexpected error condition.
72
 
73
     void commit() throws RollbackException,
74
 	HeuristicMixedException, HeuristicRollbackException, SecurityException,
75
 	IllegalStateException, SystemException;

    
 Roll back the transaction associated with the current thread. When this
 method completes, the thread is no longer associated with a transaction.

 
 Throws:java.lang.SecurityException Thrown to indicate that the thread is
    not allowed to roll back the transaction.java.lang.IllegalStateException Thrown if the current thread is
    not associated with a transaction.SystemException Thrown if the transaction manager
    encounters an unexpected error condition.
90
 
91
     void rollback() throws IllegalStateException, SecurityException,
92
         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:java.lang.IllegalStateException Thrown if the current thread is
    not associated with a transaction.SystemException Thrown if the transaction manager
    encounters an unexpected error condition.
105
106
    void setRollbackOnly() throws IllegalStateException, 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. Throws:SystemException Thrown if the transaction manager
    encounters an unexpected error condition.
118
119
    int getStatus() throws SystemException;

    
 Modify the timeout value that is associated with transactions started
 by the current thread with the begin method.

  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. Throws:SystemException Thrown if the transaction manager
    encounters an unexpected error condition.
135
136
    void setTransactionTimeout(int seconds) throws SystemException;
137
}