Package org.springframework.test.context.support

Class DirtiesContextTestExecutionListener

java.lang.Object

org.springframework.test.context.support.AbstractTestExecutionListener

org.springframework.test.context.support.AbstractDirtiesContextTestExecutionListener

org.springframework.test.context.support.DirtiesContextTestExecutionListener

All Implemented Interfaces:

Ordered, TestExecutionListener

public class DirtiesContextTestExecutionListener
extends AbstractDirtiesContextTestExecutionListener

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.

This listener supports test methods with the method mode set to AFTER_METHOD and test classes with the class mode set to AFTER_EACH_TEST_METHOD or AFTER_CLASS. For support for BEFORE modes, see DirtiesContextBeforeModesTestExecutionListener.

When merging TestExecutionListeners with the defaults, this listener will automatically be ordered after the DependencyInjectionTestExecutionListener; otherwise, this listener must be manually configured to execute after the DependencyInjectionTestExecutionListener.

Since:

2.5

Author:

Sam Brannen

See Also:

• DirtiesContext
• DirtiesContextBeforeModesTestExecutionListener

Field Summary

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor	Description
DirtiesContextTestExecutionListener()

Method Summary

Modifier and Type	Method	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.
final int	getOrder()	Returns 3000.

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

beforeOrAfterTestClass, beforeOrAfterTestMethod, dirtyContext

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

afterTestExecution, beforeTestClass, beforeTestExecution, beforeTestMethod, prepareTestInstance

Methods inherited from class java.lang.Object

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

Constructor Details

DirtiesContextTestExecutionListener

public DirtiesContextTestExecutionListener()

Method Details

getOrder

public final int getOrder()

Returns 3000.

Specified by:

getOrder in interface Ordered

Specified by:

getOrder in class AbstractDirtiesContextTestExecutionListener

Returns:

the order value

See Also:

• Ordered.HIGHEST_PRECEDENCE
• Ordered.LOWEST_PRECEDENCE

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

See Also:

• TestExecutionListener.beforeTestMethod(org.springframework.test.context.TestContext)
• TestExecutionListener.beforeTestExecution(org.springframework.test.context.TestContext)
• TestExecutionListener.afterTestExecution(org.springframework.test.context.TestContext)

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