org.apache.maven.surefire.junitcore

Class ConcurrentRunListener

java.lang.Object

org.apache.maven.surefire.junitcore.ConcurrentRunListener

All Implemented Interfaces:

ConsoleOutputReceiver, RunListener

Direct Known Subclasses:

ClassesParallelRunListener, MethodsParallelRunListener

public abstract class ConcurrentRunListener
extends Object
implements RunListener, ConsoleOutputReceiver

Handles responses from concurrent junit

Stuff to remember about JUnit threading: parallel=classes; beforeClass/afterClass, constructor and all tests method run on same thread parallel=methods; beforeClass/afterClass run on main thread, constructor + each test method run on same thread parallel=both; same as parallel=methods

Author:

Kristian Rosenvold

See Also:

for details about regular junit run listening

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract void	checkIfTestSetCanBeReported(TestSet testSetForTest)
static ConcurrentRunListener	createInstance(Map<String,TestSet> classMethodCounts, ReporterFactory reporterManagerFactory, boolean parallelClasses, boolean parallelBoth, ConsoleLogger consoleLogger)
void	testAssumptionFailure(ReportEntry failure) Event fired when a test assumption failure was encountered.
void	testError(ReportEntry failure) Event fired when a test ended with an error (non anticipated problem)
void	testFailed(ReportEntry failure) Event fired when a test ended with a failure (anticipated problem)
void	testSetCompleted(ReportEntry result) Indicates end of a given test-set
void	testSetStarting(ReportEntry description) Indicates the start of a given test-set
void	testSkipped(ReportEntry description) Event fired when a test is skipped
void	testStarting(ReportEntry description) Event fired when a test is about to start
void	testSucceeded(ReportEntry report) Event fired when a test ended successfully
void	writeTestOutput(byte[] buf, int off, int len, boolean stdout) Forwards process output from the running test-case into the reporting system

Methods inherited from class java.lang.Object

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

Method Detail

testSetStarting

public void testSetStarting(ReportEntry description)

Description copied from interface: RunListener

Indicates the start of a given test-set

Specified by:

testSetStarting in interface RunListener

Parameters:

description - the report entry describing the testset

testSetCompleted

public void testSetCompleted(ReportEntry result)

Description copied from interface: RunListener

Indicates end of a given test-set

Specified by:

testSetCompleted in interface RunListener

Parameters:

result - the report entry describing the testset

testFailed

public void testFailed(ReportEntry failure)

Description copied from interface: RunListener

Event fired when a test ended with a failure (anticipated problem)

Specified by:

testFailed in interface RunListener

Parameters:

failure - The report entry to log for

testError

public void testError(ReportEntry failure)

Description copied from interface: RunListener

Event fired when a test ended with an error (non anticipated problem)

Specified by:

testError in interface RunListener

Parameters:

failure - The report entry to log for

testSkipped

public void testSkipped(ReportEntry description)

Description copied from interface: RunListener

Event fired when a test is skipped

Specified by:

testSkipped in interface RunListener

Parameters:

description - The report entry to log for

testAssumptionFailure

public void testAssumptionFailure(ReportEntry failure)

Description copied from interface: RunListener

Event fired when a test assumption failure was encountered. An assumption failure indicates that the test is not relevant

Specified by:

testAssumptionFailure in interface RunListener

Parameters:

failure - The report entry to log for

testStarting

public void testStarting(ReportEntry description)

Description copied from interface: RunListener

Event fired when a test is about to start

Specified by:

testStarting in interface RunListener

Parameters:

description - The report entry to log for

testSucceeded

public void testSucceeded(ReportEntry report)

Description copied from interface: RunListener

Event fired when a test ended successfully

Specified by:

testSucceeded in interface RunListener

Parameters:

report - The report entry to log for

checkIfTestSetCanBeReported

protected abstract void checkIfTestSetCanBeReported(TestSet testSetForTest)

createInstance

public static ConcurrentRunListener createInstance(Map<String,TestSet> classMethodCounts,
                                   ReporterFactory reporterManagerFactory,
                                   boolean parallelClasses,
                                   boolean parallelBoth,
                                   ConsoleLogger consoleLogger)
                                            throws TestSetFailedException

Throws:

TestSetFailedException

writeTestOutput

public void writeTestOutput(byte[] buf,
                   int off,
                   int len,
                   boolean stdout)

Description copied from interface: ConsoleOutputReceiver

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

Specified by:

writeTestOutput in interface ConsoleOutputReceiver

Parameters:

buf - the buffer to write

off - offset

len - len

stdout - Indicates if this is stdout