org.apache.tools.ant.taskdefs
Class CallTarget

java.lang.Object
  |
  +--org.apache.tools.ant.ProjectComponent
        |
        +--org.apache.tools.ant.Task
              |
              +--org.apache.tools.ant.taskdefs.CallTarget

public class CallTarget
extends Task

Call another target in the same project.

    <target name="foo">
      <antcall target="bar">
        <param name="property1" value="aaaaa" />
        <param name="foo" value="baz" />
       </antcall>
    </target>

    <target name="bar" depends="init">
      <echo message="prop is ${property1} ${foo}" />
    </target>
 

This only works as expected if neither property1 nor foo are defined in the project itself.

Since:
Ant 1.2

Field Summary
 
Fields inherited from class org.apache.tools.ant.Task
description, location, target, taskName, taskType, wrapper
 
Fields inherited from class org.apache.tools.ant.ProjectComponent
project
 
Constructor Summary
CallTarget()
           
 
Method Summary
 void addPropertyset(PropertySet ps)
          Set of properties to pass to the new project.
 void addReference(Ant.Reference r)
          Reference element identifying a data type to carry over to the invoked target.
 Property createParam()
          Property to pass to the invoked target.
 void execute()
          hand off the work to the ant task of ours, after setting it up
 void handleErrorFlush(java.lang.String output)
          Pass output sent to System.err to the new project and flush stream.
 void handleErrorOutput(java.lang.String output)
          Pass output sent to System.err to the new project.
 void handleFlush(java.lang.String output)
          Pass output sent to System.out to the new project.
 int handleInput(byte[] buffer, int offset, int length)
          Handle an input request by this task
 void handleOutput(java.lang.String output)
          Pass output sent to System.out to the new project.
 void init()
          init this task by creating new instance of the ant task and configuring it's by calling its own init method.
 void setInheritAll(boolean inherit)
          If true, pass all properties to the new Ant project.
 void setInheritRefs(boolean inheritRefs)
          If true, pass all references to the new Ant project.
 void setTarget(java.lang.String target)
          Target to execute, required.
 
Methods inherited from class org.apache.tools.ant.Task
getDescription, getLocation, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, isInvalid, log, log, maybeConfigure, perform, reconfigure, setDescription, setLocation, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType
 
Methods inherited from class org.apache.tools.ant.ProjectComponent
getProject, setProject
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

CallTarget

public CallTarget()
Method Detail

setInheritAll

public void setInheritAll(boolean inherit)
If true, pass all properties to the new Ant project. Defaults to true.


setInheritRefs

public void setInheritRefs(boolean inheritRefs)
If true, pass all references to the new Ant project. Defaults to false

Parameters:
inheritRefs - new value

init

public void init()
init this task by creating new instance of the ant task and configuring it's by calling its own init method.

Overrides:
init in class Task

execute

public void execute()
             throws BuildException
hand off the work to the ant task of ours, after setting it up

Overrides:
execute in class Task
Throws:
BuildException - on validation failure or if the target didn't execute

createParam

public Property createParam()
Property to pass to the invoked target.


addReference

public void addReference(Ant.Reference r)
Reference element identifying a data type to carry over to the invoked target.

Since:
Ant 1.5

addPropertyset

public void addPropertyset(PropertySet ps)
Set of properties to pass to the new project.

Since:
Ant 1.6

setTarget

public void setTarget(java.lang.String target)
Target to execute, required.


handleOutput

public void handleOutput(java.lang.String output)
Pass output sent to System.out to the new project.

Overrides:
handleOutput in class Task
Parameters:
output - The output to log. Should not be null.
Since:
Ant 1.5

handleInput

public int handleInput(byte[] buffer,
                       int offset,
                       int length)
                throws java.io.IOException
Description copied from class: Task
Handle an input request by this task

Overrides:
handleInput in class Task
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
Returns:
the number of bytes read
Throws:
java.io.IOException - if the data cannot be read
Since:
Ant 1.6
See Also:
Task.handleInput(byte[], int, int)

handleFlush

public void handleFlush(java.lang.String output)
Pass output sent to System.out to the new project.

Overrides:
handleFlush in class Task
Parameters:
output - The output to log. Should not be null.
Since:
Ant 1.5.2

handleErrorOutput

public void handleErrorOutput(java.lang.String output)
Pass output sent to System.err to the new project.

Overrides:
handleErrorOutput in class Task
Parameters:
output - The error output to log. Should not be null.
Since:
Ant 1.5

handleErrorFlush

public void handleErrorFlush(java.lang.String output)
Pass output sent to System.err to the new project and flush stream.

Overrides:
handleErrorFlush in class Task
Parameters:
output - The error output to log. Should not be null.
Since:
Ant 1.5.2


Copyright © 2000-2004 Apache Software Foundation. All Rights Reserved.