Package org.junit.platform.runner

Class JUnitPlatformRunnerListener

java.lang.Object

org.junit.platform.runner.JUnitPlatformRunnerListener

All Implemented Interfaces:

TestExecutionListener

class JUnitPlatformRunnerListener
extends java.lang.Object
implements TestExecutionListener

Since:

1.0

Field Summary

Fields

Modifier and Type	Field	Description
private org.junit.runner.notification.RunNotifier	notifier
private JUnitPlatformTestTree	testTree

Constructor Summary

Constructors

Constructor	Description
JUnitPlatformRunnerListener(JUnitPlatformTestTree testTree, org.junit.runner.notification.RunNotifier notifier)

Method Summary

Modifier and Type	Method	Description
void	dynamicTestRegistered(TestIdentifier testIdentifier)	Called when a new, dynamic TestIdentifier has been registered.
void	executionFinished(TestIdentifier testIdentifier, TestExecutionResult testExecutionResult)	Called when the execution of a leaf or subtree of the TestPlan has finished, regardless of the outcome.
void	executionSkipped(TestIdentifier testIdentifier, java.lang.String reason)	Called when the execution of a leaf or subtree of the TestPlan has been skipped.
void	executionStarted(TestIdentifier testIdentifier)	Called when the execution of a leaf or subtree of the TestPlan is about to be started.
void	fileEntryPublished(TestIdentifier testIdentifier, FileEntry file)	Called when a file or directory has been published for the supplied TestIdentifier.
private org.junit.runner.Description	findJUnit4Description(TestIdentifier testIdentifier)
private void	fireTestIgnored(TestIdentifier testIdentifier)
void	reportingEntryPublished(TestIdentifier testIdentifier, ReportEntry entry)	Called when additional test reporting data has been published for the supplied TestIdentifier.
private org.junit.runner.notification.Failure	toFailure(TestExecutionResult testExecutionResult, org.junit.runner.Description description)

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

testPlanExecutionFinished, testPlanExecutionStarted

Field Detail

testTree

private final JUnitPlatformTestTree testTree

notifier

private final org.junit.runner.notification.RunNotifier notifier

Constructor Detail

JUnitPlatformRunnerListener

JUnitPlatformRunnerListener(JUnitPlatformTestTree testTree,
                            org.junit.runner.notification.RunNotifier notifier)

Method Detail

dynamicTestRegistered

public void dynamicTestRegistered(TestIdentifier testIdentifier)

Description copied from interface: TestExecutionListener

Called when a new, dynamic TestIdentifier 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 interface TestExecutionListener

Parameters:

testIdentifier - the identifier of the newly registered test or container

executionSkipped

public void executionSkipped(TestIdentifier testIdentifier,
                             java.lang.String reason)

Description copied from interface: TestExecutionListener

Called when the execution of a leaf or subtree of the TestPlan 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 interface TestExecutionListener

Parameters:

testIdentifier - the identifier of the skipped test or container

reason - a human-readable message describing why the execution has been skipped

fireTestIgnored

private void fireTestIgnored(TestIdentifier testIdentifier)

executionStarted

public void executionStarted(TestIdentifier testIdentifier)

Description copied from interface: TestExecutionListener

Called when the execution of a leaf or subtree of the TestPlan 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 interface TestExecutionListener

Parameters:

testIdentifier - the identifier of the started test or container

executionFinished

public void executionFinished(TestIdentifier testIdentifier,
                              TestExecutionResult testExecutionResult)

Description copied from interface: TestExecutionListener

Called when the execution of a leaf or subtree of the TestPlan 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 supplied TestIdentifier. The result does not include or aggregate the results of its children. For example, a container with a failing test will be reported as SUCCESSFUL even if one or more of its children are reported as FAILED.

Specified by:

executionFinished in interface TestExecutionListener

Parameters:

testIdentifier - the identifier of the finished test or container

testExecutionResult - the (unaggregated) result of the execution for the supplied TestIdentifier

See Also:

TestExecutionResult

reportingEntryPublished

public void reportingEntryPublished(TestIdentifier testIdentifier,
                                    ReportEntry entry)

Description copied from interface: TestExecutionListener

Called when additional test reporting data has been published for the supplied TestIdentifier.

Can be called at any time during the execution of a test plan.

Specified by:

reportingEntryPublished in interface TestExecutionListener

Parameters:

testIdentifier - describes the test or container to which the entry pertains

entry - the published ReportEntry

fileEntryPublished

public void fileEntryPublished(TestIdentifier testIdentifier,
                               FileEntry file)

Description copied from interface: TestExecutionListener

Called when a file or directory has been published for the supplied TestIdentifier.

Can be called at any time during the execution of a test plan.

Specified by:

fileEntryPublished in interface TestExecutionListener

Parameters:

testIdentifier - describes the test or container to which the entry pertains

file - the published FileEntry

toFailure

private org.junit.runner.notification.Failure toFailure(TestExecutionResult testExecutionResult,
                                                        org.junit.runner.Description description)

findJUnit4Description

private org.junit.runner.Description findJUnit4Description(TestIdentifier testIdentifier)