org.springframework.test
Class AbstractTransactionalSpringContextTests

java.lang.Object
  junit.framework.Assert
      junit.framework.TestCase
          org.springframework.test.AbstractSpringContextTests
              org.springframework.test.AbstractDependencyInjectionSpringContextTests
                  org.springframework.test.AbstractTransactionalSpringContextTests

All Implemented Interfaces:

Test

Direct Known Subclasses:

AbstractTransactionalDataSourceSpringContextTests

public abstract class AbstractTransactionalSpringContextTests
extends AbstractDependencyInjectionSpringContextTests

Convenient superclass for tests that should occur in a transaction, but normally will roll the transaction back on the completion of each test.

This is useful in a range of circumstances, allowing the following benefits:

• Ability to delete or insert any data in the database, without affecting other tests
• Providing a transactional context for any code requiring a transaction
• Ability to write anything to the database without any need to clean up.

This class is typically very fast, compared to traditional setup/teardown scripts.

If data should be left in the database, call the setComplete() method in each test. The defaultRollback() property, which defaults to true, determines whether transactions will complete by default.

Transactional behaviour requires a single bean in the context implementing the PlatformTransactionManager interface. This will be set by the superclass's Dependency Injection mechanism. If using the superclass's Field Injection mechanism, the implementation should be named "transactionManager". This mechanism allows the use of this superclass even when there's more than one transaction manager in the context.

This superclass can also be used without transaction management, if no PlatformTransactionManager bean is found in the context provided. Be careful about using this mode, as it allows the potential to permanently modify data. This mode is available only if dependency checking is turned off in the AbstractDependencyInjectionSpringContextTests superclass. The non-transactional capability is provided to enabled use of the same subclass in different environments.

Since:

1.1.1

Author:

Rod Johnson

Field Summary

protected PlatformTransactionManager	transactionManager
protected TransactionStatus	transactionStatus TransactionStatus for this test.

Fields inherited from class org.springframework.test.AbstractDependencyInjectionSpringContextTests

applicationContext, managedVariableNames

Fields inherited from class org.springframework.test.AbstractSpringContextTests

logger

Constructor Summary

AbstractTransactionalSpringContextTests()

Method Summary

protected void	endTransaction() Immediately force a commit or rollback of the transaction, according to the complete flag.
protected void	onSetUp() This implementation creates a transaction before test execution.
protected void	onSetUpBeforeTransaction() Subclasses can override this method to perform any setup operations, such as populating a database table, before the transaction created by this class.
protected void	onSetUpInTransaction() Subclasses can override this method to perform any setup operations, such as populating a database table, within the transaction created by this class.
protected void	onTearDown() This implementation ends the transaction after test execution.
protected void	onTearDownAfterTransaction() Subclasses can override this method to perform cleanup here.
protected void	onTearDownInTransaction() Subclasses can override this method to run invariant tests here.
protected void	setComplete() Cause the transaction to commit for this test method, even if default is set to rollback.
void	setDefaultRollback(boolean defaultRollback) Subclasses can set this value in their constructor to change default, which is always to roll the transaction back
void	setTransactionManager(PlatformTransactionManager ptm) The transaction manager to use.

Methods inherited from class org.springframework.test.AbstractDependencyInjectionSpringContextTests

contextKey, getConfigLocations, getLoadCount, initManagedVariableNames, isDependencyCheck, isPopulateProtectedVariables, loadContextLocations, populateProtectedVariables, setDependencyCheck, setDirty, setPopulateProtectedVariables, setUp, tearDown

Methods inherited from class org.springframework.test.AbstractSpringContextTests

contextKeyString, getContext, hasCachedContext, loadContext, setDirty

Methods inherited from class junit.framework.TestCase

countTestCases, createResult, getName, run, run, runBare, runTest, setName, toString

Methods inherited from class junit.framework.Assert

assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertFalse, assertFalse, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, assertTrue, assertTrue, fail, fail

Methods inherited from class java.lang.Object

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

Field Detail

transactionManager

protected PlatformTransactionManager transactionManager

transactionStatus

protected TransactionStatus transactionStatus

TransactionStatus for this test. Typical subclasses won't need to use it.

Constructor Detail

AbstractTransactionalSpringContextTests

public AbstractTransactionalSpringContextTests()

Method Detail

setDefaultRollback

public void setDefaultRollback(boolean defaultRollback)

Subclasses can set this value in their constructor to change default, which is always to roll the transaction back

setTransactionManager

public void setTransactionManager(PlatformTransactionManager ptm)

The transaction manager to use. No transaction management will be available if this is not set. (This mode works only if dependency checking is turned off in the AbstractDependencyInjectionSpringContextTests superclass.) Populated by dependency injection by superclass.

onSetUp

protected final void onSetUp()
                      throws Exception

This implementation creates a transaction before test execution. Override onSetUpBeforeTransaction and/or onSetUpInTransaction to add custom set-up behavior.

Overrides:

onSetUp in class AbstractDependencyInjectionSpringContextTests

Throws:

Exception - simply let any exception propagate

See Also:

onSetUpBeforeTransaction(), onSetUpInTransaction()

onSetUpBeforeTransaction

protected void onSetUpBeforeTransaction()
                                 throws Exception

Subclasses can override this method to perform any setup operations, such as populating a database table, before the transaction created by this class.

Throws:

Exception - simply let any exception propagate

onSetUpInTransaction

protected void onSetUpInTransaction()
                             throws Exception

Subclasses can override this method to perform any setup operations, such as populating a database table, within the transaction created by this class.

NB: Not called if there is no transaction management, due to no transaction manager being provided in the context.

Throws:

Exception - simply let any exception propagate

onTearDown

protected final void onTearDown()
                         throws Exception

This implementation ends the transaction after test execution. Override onTearDownInTransaction and/or onTearDownAfterTransaction to add custom tear-down behavior.

Overrides:

onTearDown in class AbstractDependencyInjectionSpringContextTests

Throws:

Exception - simply let any exception propagate

See Also:

onTearDownInTransaction(), onTearDownAfterTransaction()

onTearDownInTransaction

protected void onTearDownInTransaction()
                                throws Exception

Subclasses can override this method to run invariant tests here. The transaction is still open, so any changes made in the transaction will still be visible. There is no need to clean up the database, as rollback will follow automatically.

NB: Not called if there is no transaction management, due to no transaction manager being provided in the context.

Throws:

Exception - simply let any exception propagate

onTearDownAfterTransaction

protected void onTearDownAfterTransaction()
                                   throws Exception

Subclasses can override this method to perform cleanup here. The transaction is not open anymore at this point.

Throws:

Exception - simply let any exception propagate

setComplete

protected void setComplete()
                    throws UnsupportedOperationException

Cause the transaction to commit for this test method, even if default is set to rollback.

Throws:

UnsupportedOperationException - if the operation cannot be set to complete as no transaction manager was provided

endTransaction

protected void endTransaction()

Immediately force a commit or rollback of the transaction, according to the complete flag.

Can be used to explicitly let the transaction end early, for example to check whether lazy associations of persistent objects work outside of a transaction (i.e. have been initialized properly).

See Also:

setComplete()