org.jboss.cache.transaction
Class DummyBaseTransactionManager

java.lang.Object
  |
  +--org.jboss.cache.transaction.DummyBaseTransactionManager

All Implemented Interfaces:

java.io.Serializable, javax.transaction.TransactionManager

Direct Known Subclasses:

BatchModeTransactionManager, DummyTransactionManager

public class DummyBaseTransactionManager

extends java.lang.Object

implements javax.transaction.TransactionManager, java.io.Serializable

Author:

bela * @version $Revision: 1.2.12.1 $ * Date: May 15, 2003 * Time: 4:11:37 PM

See Also:

Serialized Form

Constructor Summary

DummyBaseTransactionManager()

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.
javax.transaction.Transaction	getTransaction() Get the transaction associated with the calling thread.
void	resume(javax.transaction.Transaction tx) Resume the association of the calling thread with the given * transaction.
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	setTransaction(javax.transaction.Transaction tx) Just used for unit tests * @param tx
void	setTransactionTimeout(int seconds) Change the transaction timeout for transactions started by the calling * thread with the begin() method.
javax.transaction.Transaction	suspend() Suspend the association the calling thread has to a transaction, * and return the suspended transaction.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DummyBaseTransactionManager

public DummyBaseTransactionManager()

Method Detail

begin

public void begin()
           throws javax.transaction.NotSupportedException,
                  javax.transaction.SystemException

Starts a new transaction, and associate it with the calling thread. * * @throws javax.transaction.NotSupportedException If the calling thread is already * associated with a transaction, and nested transactions are * not supported. * @throws javax.transaction.SystemException If the transaction service fails in an * unexpected way.

Specified by:

begin in interface javax.transaction.TransactionManager

javax.transaction.NotSupportedException

javax.transaction.SystemException

commit

public void commit()
            throws javax.transaction.RollbackException,
                   javax.transaction.HeuristicMixedException,
                   javax.transaction.HeuristicRollbackException,
                   java.lang.SecurityException,
                   java.lang.IllegalStateException,
                   javax.transaction.SystemException

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

Specified by:

commit in interface javax.transaction.TransactionManager

javax.transaction.RollbackException

javax.transaction.HeuristicMixedException

javax.transaction.HeuristicRollbackException

java.lang.SecurityException

java.lang.IllegalStateException

javax.transaction.SystemException

rollback

public void rollback()
              throws java.lang.IllegalStateException,
                     java.lang.SecurityException,
                     javax.transaction.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. * @throws SecurityException If the caller is not allowed to roll back * this transaction. * @throws javax.transaction.SystemException If the transaction service fails in an * unexpected way.

Specified by:

rollback in interface javax.transaction.TransactionManager

java.lang.IllegalStateException

java.lang.SecurityException

javax.transaction.SystemException

setRollbackOnly

public void setRollbackOnly()
                     throws java.lang.IllegalStateException,
                            javax.transaction.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. * @throws javax.transaction.SystemException If the transaction service fails in an * unexpected way.

Specified by:

setRollbackOnly in interface javax.transaction.TransactionManager

java.lang.IllegalStateException

javax.transaction.SystemException

getStatus

public int getStatus()
              throws javax.transaction.SystemException

Get the status of the transaction associated with the calling thread. * * @return 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 javax.transaction.SystemException If the transaction service fails in an * unexpected way.

Specified by:

getStatus in interface javax.transaction.TransactionManager

javax.transaction.SystemException

getTransaction

public javax.transaction.Transaction getTransaction()
                                             throws javax.transaction.SystemException

Get the transaction associated with the calling thread. * * @return The transaction associated with the calling thread, or * null if the calling thread is not associated * with a transaction. * @throws javax.transaction.SystemException If the transaction service fails in an * unexpected way.

Specified by:

getTransaction in interface javax.transaction.TransactionManager

javax.transaction.SystemException

setTransactionTimeout

public void setTransactionTimeout(int seconds)
                           throws javax.transaction.SystemException

Change the transaction timeout for transactions started by the calling * thread with the begin() method. * * @param seconds The new timeout value, in seconds. If this parameter * is 0, the timeout value is reset to the default * value. * @throws javax.transaction.SystemException If the transaction service fails in an * unexpected way.

Specified by:

setTransactionTimeout in interface javax.transaction.TransactionManager

javax.transaction.SystemException

suspend

public javax.transaction.Transaction suspend()
                                      throws javax.transaction.SystemException

Suspend the association the calling thread has to a transaction, * and return the suspended transaction. * When returning from this method, the calling thread is no longer * associated with a transaction. * * @return The transaction that the calling thread was associated with, * or null if the calling thread was not associated * with a transaction. * @throws javax.transaction.SystemException If the transaction service fails in an * unexpected way.

Specified by:

suspend in interface javax.transaction.TransactionManager

javax.transaction.SystemException

resume

public void resume(javax.transaction.Transaction tx)
            throws javax.transaction.InvalidTransactionException,
                   java.lang.IllegalStateException,
                   javax.transaction.SystemException

Resume the association of the calling thread with the given * transaction. * * @param tx The transaction to be associated with the calling thread. * @throws javax.transaction.InvalidTransactionException If the argument does not represent * a valid transaction. * @throws IllegalStateException If the calling thread is already * associated with a transaction. * @throws javax.transaction.SystemException If the transaction service fails in an * unexpected way.

Specified by:

resume in interface javax.transaction.TransactionManager

javax.transaction.InvalidTransactionException

java.lang.IllegalStateException

javax.transaction.SystemException

setTransaction

public void setTransaction(javax.transaction.Transaction tx)

Just used for unit tests * @param tx