org.springframework.transaction
Interface TransactionStatus

All Superinterfaces:
SavepointManager
All Known Implementing Classes:
DefaultTransactionStatus

public interface TransactionStatus
extends SavepointManager

Representation of the status of a transaction, consisting of a transaction object and some status flags.

Transactional code can use this to retrieve status information, and to programmatically request a rollback (instead of throwing an exception that causes an implicit rollback).

Derives from the SavepointManager interface to provide access to savepoint management facilities. Note that savepoint management is just available if the actual transaction manager supports it.

Since:
27.03.2003
Author:
Juergen Hoeller
See Also:
PlatformTransactionManager, TransactionCallback.doInTransaction(org.springframework.transaction.TransactionStatus), TransactionAspectSupport.currentTransactionStatus(), setRollbackOnly()

Method Summary
 boolean isNewTransaction()
          Return if the transaction is new, else participating in an existing transaction.
 boolean isRollbackOnly()
          Return if the transaction has been set rollback-only.
 void setRollbackOnly()
          Set the transaction rollback-only.
 
Methods inherited from interface org.springframework.transaction.SavepointManager
createSavepoint, releaseSavepoint, rollbackToSavepoint
 

Method Detail

isNewTransaction

public boolean isNewTransaction()
Return if the transaction is new, else participating in an existing transaction.


setRollbackOnly

public void setRollbackOnly()
Set the transaction rollback-only. This instructs the transaction manager that the only possible outcome of the transaction may be a rollback, proceeding with the normal applicaiton workflow though (i.e. no exception).

For transactions managed by TransactionTemplate or TransactionInterceptor. An alternative way to trigger a rollback is throwing an application exception.

See Also:
TransactionCallback.doInTransaction(org.springframework.transaction.TransactionStatus), TransactionAttribute.rollbackOn(java.lang.Throwable)

isRollbackOnly

public boolean isRollbackOnly()
Return if the transaction has been set rollback-only.



Copyright (C) 2003-2004 The Spring Framework Project.