TaskAdapter (Apache Ant API)
Date: 2015-06-29

org.apache.tools.ant

## Class TaskAdapter

- java.lang.Object
- - org.apache.tools.ant.ProjectComponent
  - - org.apache.tools.ant.Task
    - - org.apache.tools.ant.TaskAdapter

- All Implemented Interfaces:
    java.lang.Cloneable, TypeAdapter

      public class TaskAdapter
      extends Task
      implements TypeAdapter

  Uses introspection to "adapt" an arbitrary Bean which doesn't itself extend Task, but still contains an execute method and optionally a setProject method.

- - ### Field Summary

    - ### 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 and Description
    `TaskAdapter()` No-arg constructor for reflection.
    `TaskAdapter(java.lang.Object proxy)` Constructor for given proxy.

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `void` | `checkProxyClass(java.lang.Class<?> proxyClass)` Check if the proxy class is a valid class to use with this adapter.
    `static void` | `checkTaskClass(java.lang.Class<?> taskClass, Project project)` Checks whether or not a class is suitable to be adapted by TaskAdapter.
    `void` | `execute()` Executes the proxied task.
    `java.lang.Object` | `getProxy()` Returns the target object being proxied.
    `void` | `setProxy(java.lang.Object o)` Sets the target object to proxy for.

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

      `bindToOwner, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, 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`

    - ### Methods inherited from interface org.apache.tools.ant.TypeAdapter

      `getProject, setProject`

- - ### Constructor Detail

    - #### TaskAdapter

          public TaskAdapter()

      No-arg constructor for reflection.

    - #### TaskAdapter

          public TaskAdapter(java.lang.Object proxy)

      Constructor for given proxy. So you could write easier code

           myTaskContainer.addTask( new TaskAdapter(myProxy) );

      Parameters:
        `proxy` - The object which Ant should use as task.

  - ### Method Detail

    - #### checkTaskClass

          public static void checkTaskClass(java.lang.Class<?> taskClass,
                            Project project)

      Checks whether or not a class is suitable to be adapted by TaskAdapter. If the class is of type Dispatchable, the check is not performed because the method that will be executed will be determined only at runtime of the actual task and not during parse time. This only checks conditions which are additionally required for tasks adapted by TaskAdapter. Thus, this method should be called by Project.checkTaskClass. Throws a BuildException and logs as Project.MSG_ERR for conditions that will cause the task execution to fail. Logs other suspicious conditions with Project.MSG_WARN.
      Parameters:
        `taskClass` - Class to test for suitability. Must not be `null`.
        `project` - Project to log warnings/errors to. Must not be `null`.
      See Also:
        `Project.checkTaskClass(Class)`

    - #### checkProxyClass

          public void checkProxyClass(java.lang.Class<?> proxyClass)

      Check if the proxy class is a valid class to use with this adapter. The class must have a public no-arg "execute()" method.
      Specified by:
        `checkProxyClass` in interface `TypeAdapter`
      Parameters:
        `proxyClass` - the class to check.

    - #### execute

          public void execute()
                       throws BuildException

      Executes the proxied task.
      Overrides:
        `execute` in class `Task`
      Throws:
        `BuildException` - if the project could not be set or the method could not be executed.

    - #### setProxy

          public void setProxy(java.lang.Object o)

      Sets the target object to proxy for.
      Specified by:
        `setProxy` in interface `TypeAdapter`
      Parameters:
        `o` - The target object. Must not be `null`.

    - #### getProxy

          public java.lang.Object getProxy()

      Returns the target object being proxied.
      Specified by:
        `getProxy` in interface `TypeAdapter`
      Returns:
        the target proxy object.