Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
  /*
   * The contents of this file are subject to the terms 
   * of the Common Development and Distribution License 
   * (the License).  You may not use this file except in
   * compliance with the License.
   * 
   * You can obtain a copy of the license at 
   * https://glassfish.dev.java.net/public/CDDLv1.0.html or
   * glassfish/bootstrap/legal/CDDLv1.0.txt.
  * See the License for the specific language governing 
  * permissions and limitations under the License.
  * 
  * When distributing Covered Code, include this CDDL 
  * Header Notice in each file and include the License file 
  * at glassfish/bootstrap/legal/CDDLv1.0.txt.  
  * If applicable, add the following below the CDDL Header, 
  * with the fields enclosed by brackets [] replaced by
  * you own identifying information: 
  * "Portions Copyrighted [year] [name of copyright owner]"
  * 
  * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
  */
 
 package javax.transaction;
 
The TransactionManager interface defines the methods that allow an application server to manage transaction boundaries.
 
 public interface TransactionManager {

    
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.
 
     public void begin() throws NotSupportedExceptionSystemException;

    
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.
 
     public void commit() throws RollbackException,
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.
 
     public int getStatus() throws SystemException;

    
Get the transaction object that represents the transaction context of the calling thread.

Returns:
the Transaction object representing the transaction associated with the calling thread.
Throws:
SystemException Thrown if the transaction manager encounters an unexpected error condition.
    public Transaction getTransaction() throws SystemException;

    
Resume the transaction context association of the calling thread with the transaction represented by the supplied Transaction object. When this method returns, the calling thread is associated with the transaction context specified.

Parameters:
tobj The Transaction object that represents the transaction to be resumed.
Throws:
InvalidTransactionException Thrown if the parameter transaction object contains an invalid transaction.
java.lang.IllegalStateException Thrown if the thread is already associated with another transaction.
SystemException Thrown if the transaction manager encounters an unexpected error condition.
    public void resume(Transaction tobj)
            throws InvalidTransactionExceptionIllegalStateException,
            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.
    public void rollback() throws IllegalStateExceptionSecurityException,
                            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.
    public void setRollbackOnly() throws IllegalStateExceptionSystemException;

    
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.
    public void setTransactionTimeout(int secondsthrows SystemException;

    
Suspend the transaction currently associated with the calling thread and return a Transaction object that represents the transaction context being suspended. If the calling thread is not associated with a transaction, the method returns a null object reference. When this method returns, the calling thread is not associated with a transaction.

Returns:
Transaction object representing the suspended transaction.
Throws:
SystemException Thrown if the transaction manager encounters an unexpected error condition.
    public Transaction suspend() throws SystemException;
New to GrepCode? Check out our FAQ X