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:

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 configured with the @DirtiesContext annotation.

Since:

2.5

Author:

Sam Brannen, Juergen Hoeller

See Also:

DirtiesContext

Field Summary

Fields

Modifier and Type	Field and Description
private static Log	logger

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, 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, 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 DependencyInjectionTestExecutionListener.REINJECT_DEPENDENCIES_ATTRIBUTE in the test context will be set to true.
protected void	dirtyContext(TestContext testContext) Deprecated. as of Spring 3.2.2, use #dirtyContext(TestContext, HierarchyMode) instead.
protected void	dirtyContext(TestContext testContext, DirtiesContext.HierarchyMode hierarchyMode) Marks the application context of the supplied test context as dirty and sets DependencyInjectionTestExecutionListener.REINJECT_DEPENDENCIES_ATTRIBUTE in the test context to true.

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

beforeTestClass, beforeTestMethod, prepareTestInstance

Methods inherited from class java.lang.Object

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

Field Detail

logger

private static final Log logger

Constructor Detail

DirtiesContextTestExecutionListener

public DirtiesContextTestExecutionListener()

Method Detail

dirtyContext

@Deprecated
protected void dirtyContext(TestContext testContext)

Deprecated. as of Spring 3.2.2, use #dirtyContext(TestContext, HierarchyMode) instead.

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

Parameters:

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

dirtyContext

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

Marks the application context of the supplied test context as dirty and sets DependencyInjectionTestExecutionListener.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

afterTestMethod

public void afterTestMethod(TestContext testContext)
                     throws java.lang.Exception

If the current test method of the supplied test context is annotated with @DirtiesContext, 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 DependencyInjectionTestExecutionListener.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:

java.lang.Exception - allows any exception to propagate

afterTestClass

public void afterTestClass(TestContext testContext)
                    throws java.lang.Exception

If the test class of the supplied test context is annotated with @DirtiesContext, 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:

java.lang.Exception - allows any exception to propagate