Package org.apache.maven.surefire.common.junit4

Class JUnit4RunListener

java.lang.Object

org.junit.runner.notification.RunListener

org.apache.maven.surefire.common.junit4.JUnit4RunListener

All Implemented Interfaces:

TestOutputReceiver<OutputReportEntry>, RunModeSetter

Direct Known Subclasses:

JUnitCoreRunListener, NonConcurrentRunListener

public class JUnit4RunListener
extends org.junit.runner.notification.RunListener
implements TestOutputReceiver<OutputReportEntry>, RunModeSetter

RunListener for JUnit4, delegates to our own RunListener

Nested Class Summary

Nested classes/interfaces inherited from class org.junit.runner.notification.RunListener

org.junit.runner.notification.RunListener.ThreadSafe

Field Summary

Fields

Modifier and Type	Field	Description
protected final ClassMethodIndexer	classMethodIndexer
private final ThreadLocal<Boolean>	failureFlag	This flag is set after a failure has occurred so that a RunListener.testSucceeded(org.apache.maven.surefire.api.report.ReportEntry) event is not fired.
protected final TestReportListener<TestOutputReportEntry>	reporter
private RunMode	runMode

Constructor Summary

Constructors

Constructor	Description
JUnit4RunListener(TestReportListener<TestOutputReportEntry> reporter)	Constructor.

Method Summary

Modifier and Type	Method	Description
protected SimpleReportEntry	createReportEntry(org.junit.runner.Description description)
protected StackTraceWriter	createStackTraceWriter(org.junit.runner.notification.Failure failure)
final ConsoleLogger	getConsoleLogger()
protected final RunMode	getRunMode()
static void	rethrowAnyTestMechanismFailures(org.junit.runner.Result run)
void	setRunMode(RunMode runMode)
void	testAssumptionFailure(org.junit.runner.notification.Failure failure)
void	testExecutionSkippedByUser()	Delegates to RunListener.testExecutionSkippedByUser().
void	testFailure(org.junit.runner.notification.Failure failure)	Called when a specific test has failed.
void	testFinished(org.junit.runner.Description description)	Called after a specific test has finished.
void	testIgnored(org.junit.runner.Description description)	Called when a specific test has been skipped (for whatever reason).
void	testStarted(org.junit.runner.Description description)	Called when a specific test has started.
void	writeTestOutput(OutputReportEntry reportEntry)	Forwards process output from the running test-case into the reporting system

Methods inherited from class org.junit.runner.notification.RunListener

testRunFinished, testRunStarted, testSuiteFinished, testSuiteStarted

Methods inherited from class java.lang.Object

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

Field Details

classMethodIndexer

protected final ClassMethodIndexer classMethodIndexer

reporter

protected final TestReportListener<TestOutputReportEntry> reporter

runMode

private volatile RunMode runMode

failureFlag

private final ThreadLocal<Boolean> failureFlag

This flag is set after a failure has occurred so that a RunListener.testSucceeded(org.apache.maven.surefire.api.report.ReportEntry) event is not fired. This is necessary because JUnit4 always fires a RunListener.testRunFinished(Result) event-- even if there was a failure.

Constructor Details

JUnit4RunListener

public JUnit4RunListener(TestReportListener<TestOutputReportEntry> reporter)

Constructor.

Parameters:

reporter - the reporter to log testing events to

Method Details

getConsoleLogger

public final ConsoleLogger getConsoleLogger()

setRunMode

public void setRunMode(RunMode runMode)

Specified by:

setRunMode in interface RunModeSetter

getRunMode

protected final RunMode getRunMode()

testIgnored

public void testIgnored(org.junit.runner.Description description)
                 throws Exception

Called when a specific test has been skipped (for whatever reason).

Overrides:

testIgnored in class org.junit.runner.notification.RunListener

Throws:

Exception

See Also:

• RunListener.testIgnored(org.junit.runner.Description)

testStarted

public void testStarted(org.junit.runner.Description description)
                 throws Exception

Called when a specific test has started.

Overrides:

testStarted in class org.junit.runner.notification.RunListener

Throws:

Exception

See Also:

• RunListener.testStarted(org.junit.runner.Description)

testFailure

public void testFailure(org.junit.runner.notification.Failure failure)
                 throws Exception

Called when a specific test has failed.

Overrides:

testFailure in class org.junit.runner.notification.RunListener

Throws:

Exception

See Also:

• RunListener.testFailure(org.junit.runner.notification.Failure)

testAssumptionFailure

public void testAssumptionFailure(org.junit.runner.notification.Failure failure)

Overrides:

testAssumptionFailure in class org.junit.runner.notification.RunListener

testFinished

public void testFinished(org.junit.runner.Description description)
                  throws Exception

Called after a specific test has finished.

Overrides:

testFinished in class org.junit.runner.notification.RunListener

Throws:

Exception

See Also:

• RunListener.testFinished(org.junit.runner.Description)

testExecutionSkippedByUser

public void testExecutionSkippedByUser()

Delegates to RunListener.testExecutionSkippedByUser().

createStackTraceWriter

protected StackTraceWriter createStackTraceWriter(org.junit.runner.notification.Failure failure)

createReportEntry

protected SimpleReportEntry createReportEntry(org.junit.runner.Description description)

rethrowAnyTestMechanismFailures

public static void rethrowAnyTestMechanismFailures(org.junit.runner.Result run)
                                            throws TestSetFailedException

Throws:

TestSetFailedException

writeTestOutput

public void writeTestOutput(OutputReportEntry reportEntry)

Description copied from interface: TestOutputReceiver

Forwards process output from the running test-case into the reporting system

Specified by:

writeTestOutput in interface TestOutputReceiver<OutputReportEntry>

Parameters:

reportEntry - wraps test output with descriptive information of the output