org.springframework.test.context.support

Class DirtiesContextTestExecutionListener

java.lang.Object

org.springframework.test.context.support.AbstractTestExecutionListener

org.springframework.test.context.support.DirtiesContextTestExecutionListener

All Implemented Interfaces:

org.springframework.core.Ordered, TestExecutionListener

public class DirtiesContextTestExecutionListener
extends AbstractTestExecutionListener

TestExecutionListener which provides support for marking the ApplicationContext associated with a test as dirty for both test classes and test methods annotated with the @DirtiesContext annotation.

Since:

2.5

Author:

Sam Brannen, Juergen Hoeller

See Also:

DirtiesContext

Field Summary

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor and Description
DirtiesContextTestExecutionListener()

Method Summary

Modifier and Type	Method and Description
void	afterTestClass(TestContext testContext) If the test class of the supplied test context is annotated with @DirtiesContext and the class mode is set to AFTER_CLASS, the application context of the test context will be marked as dirty, and the REINJECT_DEPENDENCIES_ATTRIBUTE in the test context will be set to true.
void	afterTestMethod(TestContext testContext) If the current test method of the supplied test context is annotated with @DirtiesContext and the method mode is set to AFTER_METHOD, or if the test class is annotated with @DirtiesContext and the class mode is set to AFTER_EACH_TEST_METHOD, the application context of the test context will be marked as dirty and the REINJECT_DEPENDENCIES_ATTRIBUTE in the test context will be set to true.
void	beforeTestClass(TestContext testContext) If the test class of the supplied test context is annotated with @DirtiesContext and the class mode is set to BEFORE_CLASS, the application context of the test context will be marked as dirty, and the REINJECT_DEPENDENCIES_ATTRIBUTE in the test context will be set to true.
void	beforeTestMethod(TestContext testContext) If the current test method of the supplied test context is annotated with @DirtiesContext and the method mode is set to BEFORE_METHOD, or if the test class is annotated with @DirtiesContext and the class mode is set to BEFORE_EACH_TEST_METHOD, the application context of the test context will be marked as dirty and the REINJECT_DEPENDENCIES_ATTRIBUTE in the test context will be set to true.
protected void	dirtyContext(TestContext testContext, DirtiesContext.HierarchyMode hierarchyMode) Marks the application context of the supplied test context as dirty and sets REINJECT_DEPENDENCIES_ATTRIBUTE in the test context to true.
int	getOrder() Returns 3000.

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

prepareTestInstance

Methods inherited from class java.lang.Object

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

Constructor Detail

DirtiesContextTestExecutionListener

public DirtiesContextTestExecutionListener()

Method Detail

getOrder

public final int getOrder()

Returns 3000.

Specified by:

getOrder in interface org.springframework.core.Ordered

Overrides:

getOrder in class AbstractTestExecutionListener

beforeTestClass

public void beforeTestClass(TestContext testContext)
                     throws Exception

If the test class of the supplied test context is annotated with @DirtiesContext and the class mode is set to BEFORE_CLASS, the application context of the test context will be marked as dirty, and the REINJECT_DEPENDENCIES_ATTRIBUTE in the test context will be set to true.

Specified by:

beforeTestClass in interface TestExecutionListener

Overrides:

beforeTestClass in class AbstractTestExecutionListener

Parameters:

testContext - the test context for the test; never null

Throws:

Exception - allows any exception to propagate

beforeTestMethod

public void beforeTestMethod(TestContext testContext)
                      throws Exception

If the current test method of the supplied test context is annotated with @DirtiesContext and the method mode is set to BEFORE_METHOD, or if the test class is annotated with @DirtiesContext and the class mode is set to BEFORE_EACH_TEST_METHOD, the application context of the test context will be marked as dirty and the REINJECT_DEPENDENCIES_ATTRIBUTE in the test context will be set to true.

Specified by:

beforeTestMethod in interface TestExecutionListener

Overrides:

beforeTestMethod in class AbstractTestExecutionListener

Parameters:

testContext - the test context in which the test method will be executed; never null

Throws:

Exception - allows any exception to propagate

Since:

4.2

afterTestMethod

public void afterTestMethod(TestContext testContext)
                     throws Exception

If the current test method of the supplied test context is annotated with @DirtiesContext and the method mode is set to AFTER_METHOD, or if the test class is annotated with @DirtiesContext and the class mode is set to AFTER_EACH_TEST_METHOD, the application context of the test context will be marked as dirty and the REINJECT_DEPENDENCIES_ATTRIBUTE in the test context will be set to true.

Specified by:

afterTestMethod in interface TestExecutionListener

Overrides:

afterTestMethod in class AbstractTestExecutionListener

Parameters:

testContext - the test context in which the test method was executed; never null

Throws:

Exception - allows any exception to propagate

afterTestClass

public void afterTestClass(TestContext testContext)
                    throws Exception

If the test class of the supplied test context is annotated with @DirtiesContext and the class mode is set to AFTER_CLASS, the application context of the test context will be marked as dirty, and the REINJECT_DEPENDENCIES_ATTRIBUTE in the test context will be set to true.

Specified by:

afterTestClass in interface TestExecutionListener

Overrides:

afterTestClass in class AbstractTestExecutionListener

Parameters:

testContext - the test context for the test; never null

Throws:

Exception - allows any exception to propagate

dirtyContext

protected void dirtyContext(TestContext testContext,
                            DirtiesContext.HierarchyMode hierarchyMode)

Marks the application context of the supplied test context as dirty and sets REINJECT_DEPENDENCIES_ATTRIBUTE in the test context to true.

Parameters:

testContext - the test context whose application context should marked as dirty

hierarchyMode - the context cache clearing mode to be applied if the context is part of a hierarchy; may be null

Since:

3.2.2