Class LoggingListener
- All Implemented Interfaces:
TestExecutionListener
TestExecutionListener
for logging informational messages
for all events via a BiConsumer
that consumes Throwable
and Supplier<String>
.- Since:
- 1.0
- See Also:
-
forJavaUtilLogging()
forJavaUtilLogging(Level)
LoggingListener(BiConsumer)
-
Method Summary
Modifier and TypeMethodDescriptionvoid
dynamicTestRegistered
(TestIdentifier testIdentifier) Called when a new, dynamicTestIdentifier
has been registered.void
executionFinished
(TestIdentifier testIdentifier, TestExecutionResult testExecutionResult) Called when the execution of a leaf or subtree of theTestPlan
has finished, regardless of the outcome.void
executionSkipped
(TestIdentifier testIdentifier, String reason) Called when the execution of a leaf or subtree of theTestPlan
has been skipped.void
executionStarted
(TestIdentifier testIdentifier) Called when the execution of a leaf or subtree of theTestPlan
is about to be started.static LoggingListener
forBiConsumer
(BiConsumer<Throwable, Supplier<String>> logger) Create aLoggingListener
which delegates to the suppliedBiConsumer
for consumption of logging messages.static LoggingListener
static LoggingListener
forJavaUtilLogging
(Level logLevel) void
testPlanExecutionFinished
(TestPlan testPlan) Called when the execution of theTestPlan
has finished, after all tests have been executed.void
testPlanExecutionStarted
(TestPlan testPlan) Called when the execution of theTestPlan
has started, before any test has been executed.Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface org.junit.platform.launcher.TestExecutionListener
reportingEntryPublished
-
Method Details
-
forJavaUtilLogging
-
forJavaUtilLogging
- Parameters:
logLevel
- the log level to use; nevernull
- See Also:
-
forBiConsumer
Create aLoggingListener
which delegates to the suppliedBiConsumer
for consumption of logging messages.The
BiConsumer's
arguments are aThrowable
(potentiallynull
) and aSupplier
(nevernull
) for the log message.- Parameters:
logger
- a logger implemented as aBiConsumer
; nevernull
- See Also:
-
testPlanExecutionStarted
Description copied from interface:TestExecutionListener
Called when the execution of theTestPlan
has started, before any test has been executed.Called from the same thread as
TestExecutionListener.testPlanExecutionFinished(TestPlan)
.- Specified by:
testPlanExecutionStarted
in interfaceTestExecutionListener
- Parameters:
testPlan
- describes the tree of tests about to be executed
-
testPlanExecutionFinished
Description copied from interface:TestExecutionListener
Called when the execution of theTestPlan
has finished, after all tests have been executed.Called from the same thread as
TestExecutionListener.testPlanExecutionStarted(TestPlan)
.- Specified by:
testPlanExecutionFinished
in interfaceTestExecutionListener
- Parameters:
testPlan
- describes the tree of tests that have been executed
-
dynamicTestRegistered
Description copied from interface:TestExecutionListener
Called when a new, dynamicTestIdentifier
has been registered.A dynamic test is a test that is not known a-priori and therefore not contained in the original
TestPlan
.- Specified by:
dynamicTestRegistered
in interfaceTestExecutionListener
- Parameters:
testIdentifier
- the identifier of the newly registered test or container
-
executionStarted
Description copied from interface:TestExecutionListener
Called when the execution of a leaf or subtree of theTestPlan
is about to be started.The
TestIdentifier
may represent a test or a container.This method will only be called if the test or container has not been skipped.
This method will be called for a container
TestIdentifier
before starting or skipping any of its children.- Specified by:
executionStarted
in interfaceTestExecutionListener
- Parameters:
testIdentifier
- the identifier of the started test or container
-
executionSkipped
Description copied from interface:TestExecutionListener
Called when the execution of a leaf or subtree of theTestPlan
has been skipped.The
TestIdentifier
may represent a test or a container. In the case of a container, no listener methods will be called for any of its descendants.A skipped test or subtree of tests will never be reported as started or finished.
- Specified by:
executionSkipped
in interfaceTestExecutionListener
- Parameters:
testIdentifier
- the identifier of the skipped test or containerreason
- a human-readable message describing why the execution has been skipped
-
executionFinished
public void executionFinished(TestIdentifier testIdentifier, TestExecutionResult testExecutionResult) Description copied from interface:TestExecutionListener
Called when the execution of a leaf or subtree of theTestPlan
has finished, regardless of the outcome.The
TestIdentifier
may represent a test or a container.This method will only be called if the test or container has not been skipped.
This method will 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 suppliedTestIdentifier
. The result does not include or aggregate the results of its children. For example, a container with a failing test will be reported asSUCCESSFUL
even if one or more of its children are reported asFAILED
.- Specified by:
executionFinished
in interfaceTestExecutionListener
- Parameters:
testIdentifier
- the identifier of the finished test or containertestExecutionResult
- the (unaggregated) result of the execution for the suppliedTestIdentifier
- See Also:
-