Package org.apache.tools.ant.taskdefs.optional.junit

Interface IgnoredTestListener

All Superinterfaces:

junit.framework.TestListener

All Known Implementing Classes:

BriefJUnitResultFormatter, PlainJUnitResultFormatter, TestListenerWrapper, XMLJUnitResultFormatter

public interface IgnoredTestListener
extends junit.framework.TestListener

Provides the functionality for TestListeners to be able to be notified of the necessary JUnit4 events for test being ignored (@Ignore annotation) or skipped (Assume failures). Tests written in JUnit4 will report against the methods in this interface alongside the methods in the existing TestListener

Method Summary

Modifier and Type	Method	Description
void	testAssumptionFailure(junit.framework.Test test, Throwable exception)	Receive a report that a test has failed an assumption.
void	testIgnored(junit.framework.Test test)	Reports when a test has been marked with the @Ignore annotation.

Methods inherited from interface junit.framework.TestListener

addError, addFailure, endTest, startTest

Method Details

testIgnored

void testIgnored(junit.framework.Test test)

Reports when a test has been marked with the @Ignore annotation. The parameter should normally be typed to JUnit's JUnit4TestCaseFacade so implementing classes should be able to get the details of the ignore by casting the argument and retrieving the descriptor from the test.

Parameters:

test - the details of the test and failure that have triggered this report.

testAssumptionFailure

void testAssumptionFailure(junit.framework.Test test,
 Throwable exception)

Receive a report that a test has failed an assumption. Within JUnit4 this is normally treated as a test being skipped, although how any listener handles this is up to that specific listener.

Note: Tests that throw assumption failures will still report the endTest method, which may differ from how the addError and addFailure methods work, it's up for any implementing classes to handle this.

Parameters:

test - the details of the test and failure that have triggered this report.

exception - the AssumptionViolatedException thrown from the current assumption failure.