class ExecutionListenerAdapter extends java.lang.Object implements EngineExecutionListener
ExecutionListenerAdapter
adapts a TestPlan
and a corresponding
TestExecutionListener
to the EngineExecutionListener
API.Modifier and Type | Field and Description |
---|---|
private TestExecutionListener |
testExecutionListener |
private TestPlan |
testPlan |
Constructor and Description |
---|
ExecutionListenerAdapter(TestPlan testPlan,
TestExecutionListener testExecutionListener) |
Modifier and Type | Method and Description |
---|---|
void |
dynamicTestRegistered(TestDescriptor testDescriptor)
Must be called when a new, dynamic
TestDescriptor has been
registered. |
void |
executionFinished(TestDescriptor testDescriptor,
TestExecutionResult testExecutionResult)
Must be called when the execution of a leaf or subtree of the test tree
has finished, regardless of the outcome.
|
void |
executionSkipped(TestDescriptor testDescriptor,
java.lang.String reason)
Must be called when the execution of a leaf or subtree of the test tree
has been skipped.
|
void |
executionStarted(TestDescriptor testDescriptor)
Must be called when the execution of a leaf or subtree of the test tree
is about to be started.
|
private TestIdentifier |
getTestIdentifier(TestDescriptor testDescriptor) |
void |
reportingEntryPublished(TestDescriptor testDescriptor,
ReportEntry entry)
Can be called for any
testDescriptor in order to publish additional information, e.g.:
Output that would otherwise go to System.out
Information about test context or test data
|
private final TestPlan testPlan
private final TestExecutionListener testExecutionListener
ExecutionListenerAdapter(TestPlan testPlan, TestExecutionListener testExecutionListener)
public void dynamicTestRegistered(TestDescriptor testDescriptor)
EngineExecutionListener
TestDescriptor
has been
registered.
A dynamic test is a test that is not known a-priori and therefore was not present in the test tree when discovering tests.
dynamicTestRegistered
in interface EngineExecutionListener
testDescriptor
- the descriptor of the newly registered test
or containerpublic void executionStarted(TestDescriptor testDescriptor)
EngineExecutionListener
The TestDescriptor
may represent a test or a container. In the
case of a container, engines have to fire additional events for its
children.
This method may only be called if the test or container has not been skipped.
This method must be called for a container TestDescriptor
before starting or
skipping any of its children.
executionStarted
in interface EngineExecutionListener
testDescriptor
- the descriptor of the started test or containerpublic void executionSkipped(TestDescriptor testDescriptor, java.lang.String reason)
EngineExecutionListener
The TestDescriptor
may represent a test or a container. In the
case of a container, engines must not fire any additional events for its
descendants.
A skipped test or subtree of tests must not be reported as started or finished.
executionSkipped
in interface EngineExecutionListener
testDescriptor
- the descriptor of the skipped test or containerreason
- a human-readable message describing why the execution
has been skippedpublic void executionFinished(TestDescriptor testDescriptor, TestExecutionResult testExecutionResult)
EngineExecutionListener
The TestDescriptor
may represent a test or a container.
This method may only be called if the test or container has not been skipped.
This method must be called for a container TestIdentifier
after all of its children have been
skipped or have
finished.
The TestExecutionResult
describes the result of the execution
for the supplied testDescriptor
. The result does not include or
aggregate the results of its children. For example, a container with a
failing test must be reported as SUCCESSFUL
even
if one or more of its children are reported as FAILED
.
executionFinished
in interface EngineExecutionListener
testDescriptor
- the descriptor of the finished test or containertestExecutionResult
- the (unaggregated) result of the execution for
the supplied TestDescriptor
TestExecutionResult
public void reportingEntryPublished(TestDescriptor testDescriptor, ReportEntry entry)
EngineExecutionListener
testDescriptor
in order to publish additional information, e.g.:
System.out
The current lifecycle state of testDescriptor
is not relevant;
that means that reporting events can occur at all times.
reportingEntryPublished
in interface EngineExecutionListener
testDescriptor
- the descriptor of the test or container to which the entry belongsentry
- a ReportEntry
instance to be publishedprivate TestIdentifier getTestIdentifier(TestDescriptor testDescriptor)