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 
     
    static class 
    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
    Message if no tests have been specified.
    static final String
    Message if non-File resources have been specified.
    static final String
    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
     
  • Method Summary

    Modifier and Type
    Method
    Description
    void
    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
    Add an inherited reference.
    Add a set of inherited references.
    void
    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
    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
    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 java.lang.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:
    • ERROR_NO_TESTS

      public static final String ERROR_NO_TESTS
      Message if no tests have been specified.
      See Also:
    • ERROR_NON_FILES

      public static final String ERROR_NON_FILES
      Message if non-File resources have been specified.
      See Also:
  • 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.