public class RunListener extends Object
If you need to respond to the events during a test run, extend RunListener
and override the appropriate methods. If a listener throws an exception while processing a
test event, it will be removed for the remainder of the test run.
For example, suppose you have a Cowbell
class that you want to make a noise whenever a test fails. You could write:
public class RingingListener extends RunListener {
public void testFailure(Failure failure) {
Cowbell.ring();
}
}
To invoke your listener, you need to run your tests through JUnitCore.
public void main(String... args) {
JUnitCore core= new JUnitCore();
core.addListener(new RingingListener());
core.run(MyTestClass.class);
}
JUnitCore| Constructor and Description |
|---|
RunListener() |
| Modifier and Type | Method and Description |
|---|---|
void |
testAssumptionFailure(Failure failure)
Called when an atomic test flags that it assumes a condition that is
false
|
void |
testFailure(Failure failure)
Called when an atomic test fails.
|
void |
testFinished(Description description)
Called when an atomic test has finished, whether the test succeeds or fails.
|
void |
testIgnored(Description description)
Called when a test will not be run, generally because a test method is annotated
with
Ignore. |
void |
testRunFinished(Result result)
Called when all tests have finished
|
void |
testRunStarted(Description description)
Called before any tests have been run.
|
void |
testStarted(Description description)
Called when an atomic test is about to be started.
|
public void testRunStarted(Description description) throws Exception
description - describes the tests to be runExceptionpublic void testRunFinished(Result result) throws Exception
result - the summary of the test run, including all the tests that failedExceptionpublic void testStarted(Description description) throws Exception
description - the description of the test that is about to be run
(generally a class and method name)Exceptionpublic void testFinished(Description description) throws Exception
description - the description of the test that just ranExceptionpublic void testFailure(Failure failure) throws Exception
failure - describes the test that failed and the exception that was thrownExceptionpublic void testAssumptionFailure(Failure failure)
failure - describes the test that failed and the
AssumptionViolatedException that was thrownpublic void testIgnored(Description description) throws Exception
Ignore.description - describes the test that will not be runException