org.broadleafcommerce.test

Class MergeTransactionalTestExecutionListener

java.lang.Object

org.springframework.test.context.support.AbstractTestExecutionListener

org.broadleafcommerce.test.MergeTransactionalTestExecutionListener

All Implemented Interfaces:

org.springframework.core.Ordered, org.springframework.test.context.TestExecutionListener

public class MergeTransactionalTestExecutionListener
extends org.springframework.test.context.support.AbstractTestExecutionListener

TestExecutionListener which provides support for executing tests within transactions by using @Transactional and @NotTransactional annotations.

Changes to the database during a test run with @Transactional will be run within a transaction that will, by default, be automatically rolled back after completion of the test; whereas, changes to the database during a test run with @NotTransactional will not be run within a transaction. Similarly, test methods that are not annotated with either @Transactional (at the class or method level) or @NotTransactional will not be run within a transaction.

Transactional commit and rollback behavior can be configured via the class-level @TransactionConfiguration and method-level @Rollback annotations. @TransactionConfiguration also provides configuration of the bean name of the PlatformTransactionManager that is to be used to drive transactions.

When executing transactional tests, it is sometimes useful to be able execute certain set up or tear down code outside of a transaction. TransactionalTestExecutionListener provides such support for methods annotated with @BeforeTransaction and @AfterTransaction.

This implementation will only wrap those test methods that are explicitly annotated with the Transactional annotation.

Author:

Jeff Fischer, Sam Brannen, Juergen Hoeller

See Also:

TransactionConfiguration, Transactional, org.springframework.test.annotation.NotTransactional, Rollback, BeforeTransaction, AfterTransaction

Field Summary

Fields

Modifier and Type	Field and Description
protected org.springframework.transaction.interceptor.TransactionAttributeSource	attributeSource

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor and Description
MergeTransactionalTestExecutionListener()

Method Summary

Modifier and Type	Method and Description
void	afterTestMethod(org.springframework.test.context.TestContext testContext) If a transaction is currently active for the test method of the supplied test context, this method will end the transaction and run @AfterTransaction methods.
void	beforeTestMethod(org.springframework.test.context.TestContext testContext) If the test method of the supplied test context is configured to run within a transaction, this method will run @BeforeTransaction methods and start a new transaction.
protected org.springframework.transaction.PlatformTransactionManager	getTransactionManager(org.springframework.test.context.TestContext testContext) Get the transaction manager to use for the supplied test context.
protected boolean	isDefaultRollback(org.springframework.test.context.TestContext testContext) Determine whether or not to rollback transactions by default for the supplied test context.
protected boolean	isRollback(org.springframework.test.context.TestContext testContext) Determine whether or not to rollback transactions for the supplied test context by taking into consideration the default rollback flag and a possible method-level override via the Rollback annotation.
protected void	runAfterTransactionMethods(org.springframework.test.context.TestContext testContext) Run all @AfterTransaction methods for the specified test context.
protected void	runBeforeTransactionMethods(org.springframework.test.context.TestContext testContext) Run all @BeforeTransaction methods for the specified test context.

Methods inherited from class org.springframework.test.context.support.AbstractTestExecutionListener

afterTestClass, beforeTestClass, getOrder, prepareTestInstance

Methods inherited from class java.lang.Object

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

Field Detail

attributeSource

protected final org.springframework.transaction.interceptor.TransactionAttributeSource attributeSource

Constructor Detail

MergeTransactionalTestExecutionListener

public MergeTransactionalTestExecutionListener()

Method Detail

beforeTestMethod

public void beforeTestMethod(org.springframework.test.context.TestContext testContext)
                      throws Exception

If the test method of the supplied test context is configured to run within a transaction, this method will run @BeforeTransaction methods and start a new transaction.

Note that if a @BeforeTransaction method fails, remaining @BeforeTransaction methods will not be invoked, and a transaction will not be started.

Specified by:

beforeTestMethod in interface org.springframework.test.context.TestExecutionListener

Overrides:

beforeTestMethod in class org.springframework.test.context.support.AbstractTestExecutionListener

Throws:

Exception

See Also:

Transactional, org.springframework.test.annotation.NotTransactional

afterTestMethod

public void afterTestMethod(org.springframework.test.context.TestContext testContext)
                     throws Exception

If a transaction is currently active for the test method of the supplied test context, this method will end the transaction and run @AfterTransaction methods.

@AfterTransaction methods are guaranteed to be invoked even if an error occurs while ending the transaction.

Specified by:

afterTestMethod in interface org.springframework.test.context.TestExecutionListener

Overrides:

afterTestMethod in class org.springframework.test.context.support.AbstractTestExecutionListener

Throws:

Exception

runBeforeTransactionMethods

protected void runBeforeTransactionMethods(org.springframework.test.context.TestContext testContext)
                                    throws Exception

Run all @BeforeTransaction methods for the specified test context. If one of the methods fails, however, the caught exception will be rethrown in a wrapped RuntimeException, and the remaining methods will not be given a chance to execute.

Parameters:

testContext - the current test context

Throws:

Exception

runAfterTransactionMethods

protected void runAfterTransactionMethods(org.springframework.test.context.TestContext testContext)
                                   throws Exception

Run all @AfterTransaction methods for the specified test context. If one of the methods fails, the caught exception will be logged as an error, and the remaining methods will be given a chance to execute. After all methods have executed, the first caught exception, if any, will be rethrown.

Parameters:

testContext - the current test context

Throws:

Exception

getTransactionManager

protected final org.springframework.transaction.PlatformTransactionManager getTransactionManager(org.springframework.test.context.TestContext testContext)

Get the transaction manager to use for the supplied test context.

Parameters:

testContext - the test context for which the transaction manager should be retrieved

Returns:

the transaction manager to use, or null if not found

Throws:

org.springframework.beans.BeansException - if an error occurs while retrieving the transaction manager

isDefaultRollback

protected final boolean isDefaultRollback(org.springframework.test.context.TestContext testContext)
                                   throws Exception

Determine whether or not to rollback transactions by default for the supplied test context.

Parameters:

testContext - the test context for which the default rollback flag should be retrieved

Returns:

the default rollback flag for the supplied test context

Throws:

Exception - if an error occurs while determining the default rollback flag

isRollback

protected final boolean isRollback(org.springframework.test.context.TestContext testContext)
                            throws Exception

Determine whether or not to rollback transactions for the supplied test context by taking into consideration the default rollback flag and a possible method-level override via the Rollback annotation.

Parameters:

testContext - the test context for which the rollback flag should be retrieved

Returns:

the rollback flag for the supplied test context

Throws:

Exception - if an error occurs while determining the rollback flag