BlockFor (Apache Ant API)
Date: 2018-07-10

org.apache.tools.ant.taskdefs.optional.testing

## Class BlockFor

- java.lang.Object
- - org.apache.tools.ant.ProjectComponent
  - - org.apache.tools.ant.taskdefs.condition.ConditionBase
    - - org.apache.tools.ant.taskdefs.WaitFor
      - - org.apache.tools.ant.taskdefs.optional.testing.BlockFor

- All Implemented Interfaces:
    java.lang.Cloneable

      public class BlockFor
      extends WaitFor

  Since:
    Ant 1.8

- - ### Nested Class Summary

    - ### Nested classes/interfaces inherited from class org.apache.tools.ant.taskdefs.WaitFor

      `WaitFor.Unit`

  - ### Field Summary

    - ### Fields inherited from class org.apache.tools.ant.taskdefs.WaitFor

      `DEFAULT_CHECK_MILLIS, DEFAULT_MAX_WAIT_MILLIS, ONE_DAY, ONE_HOUR, ONE_MILLISECOND, ONE_MINUTE, ONE_SECOND, ONE_WEEK`

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

      `description, location, project`

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `BlockFor()` Constructor that takes the name of the task in the task name.
    `BlockFor(java.lang.String taskName)` Constructor that takes the name of the task in the task name.

  - ### Method Summary

    All Methods Instance Methods Concrete Methods
    Modifier and Type | Method and Description
    --- | ---
    `void` | `addText(java.lang.String message)` Set the error text; all properties are expanded in the message.
    `protected void` | `processTimeout()` If the wait fails, a BuildException is thrown.

    - ### Methods inherited from class org.apache.tools.ant.taskdefs.WaitFor

      `calculateCheckEveryMillis, calculateMaxWaitMillis, execute, processSuccess, setCheckEvery, setCheckEveryUnit, setMaxWait, setMaxWaitUnit, setTimeoutProperty`

    - ### Methods inherited from class org.apache.tools.ant.taskdefs.condition.ConditionBase

      `add, addAnd, addAvailable, addChecksum, addContains, addEquals, addFilesMatch, addHttp, addIsFalse, addIsFileSelected, addIsReference, addIsSet, addIsTrue, addNot, addOr, addOs, addSocket, addUptodate, countConditions, getConditions, getTaskName, setTaskName`

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

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

    - ### Methods inherited from class java.lang.Object

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

- - ### Constructor Detail

    - #### BlockFor

          public BlockFor()

      Constructor that takes the name of the task in the task name.

    - #### BlockFor

          public BlockFor(java.lang.String taskName)

      Constructor that takes the name of the task in the task name.
      Parameters:
        `taskName` - the name of the task.

  - ### Method Detail

    - #### processTimeout

          protected void processTimeout()
                                 throws BuildTimeoutException

      If the wait fails, a BuildException is thrown. All the superclasses actions are called first.
      Overrides:
        `processTimeout` in class `WaitFor`
      Throws:
        `BuildTimeoutException` - on timeout, using the text in `text`

    - #### addText

          public void addText(java.lang.String message)

      Set the error text; all properties are expanded in the message.
      Parameters:
        `message` - the text to use in a failure message