Class AntUnit

java.lang.Object

org.apache.tools.ant.ProjectComponent

org.apache.tools.ant.Task

org.apache.ant.antunit.AntUnit

All Implemented Interfaces:

Cloneable

public class AntUnit
extends org.apache.tools.ant.Task

Run every target whose name starts with "test" in a set of build files.

Run the "setUp" target before each of them if present, same for "tearDown" after each "test*" target (targets named just "test" are ignored). If a target throws an AssertionFailedException, the test has failed; any other exception is considered an error (although BuildException will be scanned recursively for nested AssertionFailedExceptions).

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	AntUnit.Reference
static class	AntUnit.ReferenceSet	Defines a collection of inherited references, with an optional nested Mapper that maps them to new reference IDs in the target project.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ERROR_NO_TESTS	Message if no tests have been specified.
static final String	ERROR_NON_FILES	Message if non-File resources have been specified.
static final String	ERROR_TESTS_FAILED	Message to print if an error or failure occured.

Fields inherited from class org.apache.tools.ant.Task

target, taskName, taskType, wrapper

Fields inherited from class org.apache.tools.ant.ProjectComponent

description, location, project

Constructor Summary

Constructors

Constructor	Description
AntUnit()

Method Summary

Modifier and Type	Method	Description
void	add(AntUnitListener al)	Add a test listener.
void	add(org.apache.tools.ant.types.ResourceCollection rc)	Add build files to run as tests.
void	addPropertySet(org.apache.tools.ant.types.PropertySet ps)	Add a PropertySet.
void	addReference(AntUnit.Reference reference)	Add an inherited reference.
AntUnit.ReferenceSet	createReferenceSet()	Add a set of inherited references.
void	execute()	Execute the tests.
void	handleErrorFlush(String errorOutputToFlush)	Redirect error flush to new project instance.
void	handleErrorOutput(String errorOutputToHandle)	Redirect error output to new project instance.
void	handleFlush(String toFlush)	Redirect flush to new project instance.
int	handleInput(byte[] buffer, int offset, int length)	Redirect input to new project instance.
void	handleOutput(String outputToHandle)	Redirect output to new project instance.
void	setErrorProperty(String s)	Set the name of a property to set if an error or failure occurs.
void	setFailOnError(boolean failOnError)	Set whether to stop testing if an error or failure occurs?

Methods inherited from class org.apache.tools.ant.Task

bindToOwner, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, init, isInvalid, log, log, log, log, maybeConfigure, perform, reconfigure, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType

Methods inherited from class org.apache.tools.ant.ProjectComponent

clone, getDescription, getLocation, getProject, setDescription, setLocation, setProject

Methods inherited from class Object

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

Field Details

ERROR_TESTS_FAILED

public static final String ERROR_TESTS_FAILED

Message to print if an error or failure occured.

See Also:

• Constant Field Values

ERROR_NO_TESTS

public static final String ERROR_NO_TESTS

Message if no tests have been specified.

See Also:

• Constant Field Values

ERROR_NON_FILES

public static final String ERROR_NON_FILES

Message if non-File resources have been specified.

See Also:

• Constant Field Values

Constructor Details

AntUnit

public AntUnit()

Method Details

add

public void add(org.apache.tools.ant.types.ResourceCollection rc)

Add build files to run as tests.

Parameters:

rc - the ResourceCollection to add.

add

public void add(AntUnitListener al)

Add a test listener.

Parameters:

al - the AntUnitListener to add.

addPropertySet

public void addPropertySet(org.apache.tools.ant.types.PropertySet ps)

Add a PropertySet.

Parameters:

ps - the PropertySet to add.

createReferenceSet

public AntUnit.ReferenceSet createReferenceSet()

Add a set of inherited references.

Returns:

set of inherited references

addReference

public void addReference(AntUnit.Reference reference)

Add an inherited reference.

Parameters:

reference - inherited reference

setErrorProperty

public void setErrorProperty(String s)

Set the name of a property to set if an error or failure occurs.

Parameters:

s - the name of the error property.

setFailOnError

public void setFailOnError(boolean failOnError)

Set whether to stop testing if an error or failure occurs?

Parameters:

failOnError - default true

execute

public void execute()

Execute the tests.

Overrides:

execute in class org.apache.tools.ant.Task

handleOutput

public void handleOutput(String outputToHandle)

Redirect output to new project instance.

Overrides:

handleOutput in class org.apache.tools.ant.Task

Parameters:

outputToHandle - the output to handle.

handleInput

public int handleInput(byte[] buffer,
 int offset,
 int length)
                throws IOException

Redirect input to new project instance.

Overrides:

handleInput in class org.apache.tools.ant.Task

Parameters:

buffer - the buffer containing the input.

offset - the offset into buffer.

length - the length of the data.

Throws:

IOException

handleFlush

public void handleFlush(String toFlush)

Redirect flush to new project instance.

Overrides:

handleFlush in class org.apache.tools.ant.Task

Parameters:

toFlush - the output String to flush.

handleErrorOutput

public void handleErrorOutput(String errorOutputToHandle)

Redirect error output to new project instance.

Overrides:

handleErrorOutput in class org.apache.tools.ant.Task

Parameters:

errorOutputToHandle - the error output to handle.

handleErrorFlush

public void handleErrorFlush(String errorOutputToFlush)

Redirect error flush to new project instance.

Overrides:

handleErrorFlush in class org.apache.tools.ant.Task

Parameters:

errorOutputToFlush - the error output to flush.