Bind a task to another; use this when configuring a newly created task to do work on behalf of another.

  Bind a task to another; use this when configuring a newly created
task to do work on behalf of another.
Project, OwningTarget, TaskName, Location and Description are all copied

Important: this method does not call Task.init().
If you are creating a task to delegate work to, call Task.init()
to initialize it.
Parameters:
- owner - owning target
Since: Ant1.7

 

 
Returns: a shallow copy of this projectcomponent.
Throws:
- java.lang.CloneNotSupportedException - does not happen, but is declared to allow subclasses to do so.
Since: Ant 1.7

  Returns the description of the current action.

  Returns the description of the current action.
Returns: the description of the current action, or null if no description is available.

  Returns the file/location where this task was defined.

  Returns the file/location where this task was defined.
Returns: the file/location where this task was defined. Should not return null. Location.UNKNOWN_LOCATION is used for unknown locations.
See Also: Location.UNKNOWN_LOCATION,

  Returns the container target of this task.

  Returns the container target of this task.
Returns: The target containing this task, or null if this task is a top-level task.

  Returns the project to which this component belongs.

  Returns the project to which this component belongs.
Returns: the components's project.

  Returns the wrapper used for runtime configuration.

  Returns the wrapper used for runtime configuration.
Returns: the wrapper used for runtime configuration. This method will generate a new wrapper (and cache it) if one isn't set already.

  Returns the name to use in logging messages.

  Returns the name to use in logging messages.
Returns: the name to use in logging messages.

  Return the type of task.

  Return the type of task.
Returns: the type of task.

  Return the runtime configurable structure for this task.

  Return the runtime configurable structure for this task.
Returns: the runtime structure for this task.

  Handles an error line by logging it with the WARN priority.

  Handles an error line by logging it with the WARN priority.
Parameters:
- output - The error output to log. Should not be null.
Since: Ant 1.5.2

  Handles an error output by logging it with the WARN priority.

  Handles an error output by logging it with the WARN priority.
Parameters:
- output - The error output to log. Should not be null.

  Handles output by logging it with the INFO priority.

  Handles output by logging it with the INFO priority.
Parameters:
- output - The output to log. Should not be null.
Since: Ant 1.5.2

  Handle an input request by this task.

  Handle an input request by this task.
Returns: the number of bytes read.
Parameters:
- buffer - the buffer into which data is to be read.
- offset - the offset into the buffer at which data is stored.
- length - the amount of data to read.
Throws:
- java.io.IOException - if the data cannot be read.
Since: Ant 1.6

  Handles output by logging it with the INFO priority.

  Handles output by logging it with the INFO priority.
Parameters:
- output - The output to log. Should not be null.

  Called by the project to let the task initialize properly.

  Called by the project to let the task initialize properly.
The default implementation is a no-op.
Throws:
- BuildException - if something goes wrong with the build

  Has this task been marked invalid?

  Has this task been marked invalid?
Returns: true if this task is no longer valid. A new task should be configured in this case.
Since: Ant 1.5

  Logs a message with the default (INFO) priority.

  Logs a message with the default (INFO) priority.
Parameters:
- msg - The message to be logged. Should not be null.

  Logs a message with the given priority.

  Logs a message with the given priority. This delegates
the actual logging to the project.
Parameters:
- msg - The message to be logged. Should not be null.
- msgLevel - The message priority at which this message is to be logged.

  Logs a message with the given priority.

  Logs a message with the given priority. This delegates
the actual logging to the project.
Parameters:
- msg - The message to be logged. Should not be null.
- t - The exception to be logged. May be null.
- msgLevel - The message priority at which this message is to be logged.
Since: 1.7

  Logs a message with the given priority.

  Logs a message with the given priority. This delegates
the actual logging to the project.
Parameters:
- t - The exception to be logged. Should not be null.
- msgLevel - The message priority at which this message is to be logged.
Since: 1.7

  Configures this task - if it hasn't been done already.

  Configures this task - if it hasn't been done already.
If the task has been invalidated, it is replaced with an
UnknownElement task which uses the new definition in the project.
Throws:
- BuildException - if the task cannot be configured.

  Performs this task if it's still valid, or gets a replacement version and performs that otherwise.

  Performs this task if it's still valid, or gets a replacement
version and performs that otherwise.

Performing a task consists of firing a task started event,
configuring the task, executing it, and then firing task finished
event. If a runtime exception is thrown, the task finished event
is still fired, but with the exception as the cause.

Force the task to be reconfigured from its RuntimeConfigurable.

  Sets a description of the current action.

  Sets a description of the current action. This may be used for logging
purposes.
Parameters:
- desc - Description of the current action. May be null, indicating that no description is available.

  Sets the file/location where this task was defined.

  Sets the file/location where this task was defined.
Parameters:
- location - The file/location where this task was defined. Should not be null--use Location.UNKNOWN_LOCATION if the location isn't known.
See Also: Location.UNKNOWN_LOCATION,

  Sets the target container of this task.

  Sets the target container of this task.
Parameters:
- target - Target in whose scope this task belongs. May be null, indicating a top-level task.

  Sets the project object of this component.

  Sets the project object of this component. This method is used by
Project when a component is added to it so that the component has
access to the functions of the project. It should not be used
for any other purpose.
Parameters:
- project - Project in whose scope this component belongs. Must not be null.

  Sets the wrapper to be used for runtime configuration.

  Sets the wrapper to be used for runtime configuration.

This method should be used only by the ProjectHelper and Ant internals.
It is public to allow helper plugins to operate on tasks, normal tasks
should never use it.
Parameters:
- wrapper - The wrapper to be used for runtime configuration. May be null, in which case the next call to getRuntimeConfigurableWrapper will generate a new wrapper.

  Sets the name to use in logging messages.

  Sets the name to use in logging messages.
Parameters:
- name - The name to use in logging messages. Should not be null.

  Sets the name with which the task has been invoked.

  Sets the name with which the task has been invoked.
Parameters:
- type - The name the task has been invoked as. Should not be null.