org.springframework.test.context.web

Class ServletTestExecutionListener

java.lang.Object

org.springframework.test.context.support.AbstractTestExecutionListener

org.springframework.test.context.web.ServletTestExecutionListener

All Implemented Interfaces:

TestExecutionListener

public class ServletTestExecutionListener
extends AbstractTestExecutionListener

TestExecutionListener which provides mock Servlet API support to WebApplicationContexts loaded by the Spring TestContext Framework.

Specifically, ServletTestExecutionListener sets up thread-local state via Spring Web's RequestContextHolder during test instance preparation and before each test method and creates a MockHttpServletRequest, MockHttpServletResponse, and ServletWebRequest based on the MockServletContext present in the WebApplicationContext. This listener also ensures that the MockHttpServletResponse and ServletWebRequest can be injected into the test instance, and once the test is complete this listener cleans up thread-local state.

Note that ServletTestExecutionListener is enabled by default but generally takes no action if the test class is not annotated with @WebAppConfiguration. See the Javadoc for individual methods in this class for details.

Since:

3.2

Author:

Sam Brannen

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	POPULATED_REQUEST_CONTEXT_HOLDER_ATTRIBUTE Attribute name for a TestContext attribute which indicates that ServletTestExecutionListener has already populated Spring Web's RequestContextHolder.
static java.lang.String	RESET_REQUEST_CONTEXT_HOLDER_ATTRIBUTE Attribute name for a TestContext attribute which indicates whether or not the ServletTestExecutionListener should reset Spring Web's RequestContextHolder in afterTestMethod(TestContext).

Constructor Summary

Constructors

Constructor and Description
ServletTestExecutionListener()

Method Summary

Methods

Modifier and Type	Method and Description
void	afterTestMethod(TestContext testContext) If the RESET_REQUEST_CONTEXT_HOLDER_ATTRIBUTE in the supplied TestContext has a value of Boolean.TRUE, this method will (1) clean up thread-local state after each test method by resetting Spring Web's RequestContextHolder and (2) ensure that new mocks are injected into the test instance for subsequent tests by setting the DependencyInjectionTestExecutionListener.REINJECT_DEPENDENCIES_ATTRIBUTE in the test context to true.
void	beforeTestMethod(TestContext testContext) Sets up thread-local state before each test method via Spring Web's RequestContextHolder, but only if the test class is annotated with @WebAppConfiguration.
void	prepareTestInstance(TestContext testContext) Sets up thread-local state during the test instance preparation callback phase via Spring Web's RequestContextHolder, but only if the test class is annotated with @WebAppConfiguration.

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

afterTestClass, beforeTestClass

Methods inherited from class java.lang.Object

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

Field Detail

RESET_REQUEST_CONTEXT_HOLDER_ATTRIBUTE

public static final java.lang.String RESET_REQUEST_CONTEXT_HOLDER_ATTRIBUTE

Attribute name for a TestContext attribute which indicates whether or not the ServletTestExecutionListener should reset Spring Web's RequestContextHolder in afterTestMethod(TestContext).

Permissible values include Boolean.TRUE and Boolean.FALSE.

POPULATED_REQUEST_CONTEXT_HOLDER_ATTRIBUTE

public static final java.lang.String POPULATED_REQUEST_CONTEXT_HOLDER_ATTRIBUTE

Attribute name for a TestContext attribute which indicates that ServletTestExecutionListener has already populated Spring Web's RequestContextHolder.

Permissible values include Boolean.TRUE and Boolean.FALSE.

Constructor Detail

ServletTestExecutionListener

public ServletTestExecutionListener()

Method Detail

prepareTestInstance

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

Sets up thread-local state during the test instance preparation callback phase via Spring Web's RequestContextHolder, but only if the test class is annotated with @WebAppConfiguration.

Specified by:

prepareTestInstance in interface TestExecutionListener

Overrides:

prepareTestInstance in class AbstractTestExecutionListener

Parameters:

testContext - the test context for the test; never null

Throws:

java.lang.Exception - allows any exception to propagate

See Also:

TestExecutionListener.prepareTestInstance(TestContext), setUpRequestContextIfNecessary(TestContext)

beforeTestMethod

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

Sets up thread-local state before each test method via Spring Web's RequestContextHolder, but only if the test class is annotated with @WebAppConfiguration.

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:

java.lang.Exception - allows any exception to propagate

See Also:

TestExecutionListener.beforeTestMethod(TestContext), setUpRequestContextIfNecessary(TestContext)

afterTestMethod

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

If the RESET_REQUEST_CONTEXT_HOLDER_ATTRIBUTE in the supplied TestContext has a value of Boolean.TRUE, this method will (1) clean up thread-local state after each test method by resetting Spring Web's RequestContextHolder and (2) ensure that new mocks are injected into the test instance for subsequent tests by setting the DependencyInjectionTestExecutionListener.REINJECT_DEPENDENCIES_ATTRIBUTE in the test context to true.

The RESET_REQUEST_CONTEXT_HOLDER_ATTRIBUTE and POPULATED_REQUEST_CONTEXT_HOLDER_ATTRIBUTE will be subsequently removed from the test context, regardless of their values.

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

See Also:

TestExecutionListener.afterTestMethod(TestContext)