public interface TestExecutionListener
TestExecutionListener
defines a listener API for reacting to
test execution events published by the TestContextManager
with which
the listener is registered.
Concrete implementations must provide a public
no-args constructor,
so that listeners can be instantiated transparently by tools and configuration
mechanisms.
Implementations may optionally declare the position in which they should
be ordered among the chain of default listeners via the
Ordered
interface or
@Order
annotation. See
TestContextBootstrapper.getTestExecutionListeners()
for details.
Spring provides the following out-of-the-box implementations (all of
which implement Ordered
):
Modifier and Type | Method and Description |
---|---|
void |
afterTestClass(TestContext testContext)
Post-processes a test class after execution of all tests within
the class.
|
void |
afterTestMethod(TestContext testContext)
Post-processes a test after execution of the
test method in the supplied
test context , for example by tearing down test
fixtures. |
void |
beforeTestClass(TestContext testContext)
Pre-processes a test class before execution of all tests within
the class.
|
void |
beforeTestMethod(TestContext testContext)
Pre-processes a test before execution of the
test method in the supplied
test context , for example by setting up test
fixtures. |
void |
prepareTestInstance(TestContext testContext)
Prepares the
test instance of the supplied
test context , for example by injecting dependencies. |
void beforeTestClass(TestContext testContext) throws Exception
This method should be called immediately before framework-specific before class lifecycle callbacks.
If a given testing framework does not support before class lifecycle callbacks, this method will not be called for that framework.
testContext
- the test context for the test; never null
Exception
- allows any exception to propagatevoid prepareTestInstance(TestContext testContext) throws Exception
test instance
of the supplied
test context
, for example by injecting dependencies.
This method should be called immediately after instantiation of the test instance but prior to any framework-specific lifecycle callbacks.
testContext
- the test context for the test; never null
Exception
- allows any exception to propagatevoid beforeTestMethod(TestContext testContext) throws Exception
test method
in the supplied
test context
, for example by setting up test
fixtures.
This method should be called immediately prior to framework-specific before lifecycle callbacks.
testContext
- the test context in which the test method will be
executed; never null
Exception
- allows any exception to propagatevoid afterTestMethod(TestContext testContext) throws Exception
test method
in the supplied
test context
, for example by tearing down test
fixtures.
This method should be called immediately after framework-specific after lifecycle callbacks.
testContext
- the test context in which the test method was
executed; never null
Exception
- allows any exception to propagatevoid afterTestClass(TestContext testContext) throws Exception
This method should be called immediately after framework-specific after class lifecycle callbacks.
If a given testing framework does not support after class lifecycle callbacks, this method will not be called for that framework.
testContext
- the test context for the test; never null
Exception
- allows any exception to propagate