org.apache.tools.ant.taskdefs

Class SubAnt

public class SubAnt extends Task

Calls a given target for all defined sub-builds. This is an extension of ant for bulk project execution.

Use with directories

subant can be used with directory sets to execute a build from different directories. 2 different options are offered

Since: Ant1.6

UNKNOWN: name="subant" category="control"

Method Summary
voidadd(ResourceCollection rc)
Adds a resource collection to the implicit build path.
voidaddConfiguredTarget(Ant.TargetElement t)
Add a target to this Ant invocation.
voidaddDirset(DirSet set)
Adds a directory set to the implicit build path.
voidaddFilelist(FileList list)
Adds an ordered file list to the implicit build path.
voidaddFileset(FileSet set)
Adds a file set to the implicit build path.
voidaddProperty(Property p)
Corresponds to <ant>'s nested <property> element.
voidaddPropertyset(PropertySet ps)
Corresponds to <ant>'s nested <propertyset> element.
voidaddReference(Ant.Reference r)
Corresponds to <ant>'s nested <reference> element.
PathcreateBuildpath()
Creates a nested build path, and add it to the implicit build path.
Path.PathElementcreateBuildpathElement()
Creates a nested <buildpathelement>, and add it to the implicit build path.
voidexecute()
Runs the various sub-builds.
protected StringgetDefaultBuildFile()
Get the default build file name to use when launching the task.
voidhandleErrorFlush(String output)
Pass output sent to System.err to the new project.
voidhandleErrorOutput(String output)
Pass output sent to System.err to the new project.
voidhandleFlush(String output)
Pass output sent to System.out to the new project.
inthandleInput(byte[] buffer, int offset, int length)
Process input into the ant task
voidhandleOutput(String output)
Pass output sent to System.out to the new project.
voidsetAntfile(String antfile)
This method builds the file name to use in conjunction with directories.
voidsetBuildpath(Path s)
Set the buildpath to be used to find sub-projects.
voidsetBuildpathRef(Reference r)
Buildpath to use, by reference.
voidsetFailonerror(boolean failOnError)
Sets whether to fail with a build exception on error, or go on.
voidsetGenericAntfile(File afile)
This method builds a file path to use in conjunction with directories.
voidsetInheritall(boolean b)
Corresponds to <ant>'s inheritall attribute.
voidsetInheritrefs(boolean b)
Corresponds to <ant>'s inheritrefs attribute.
voidsetOutput(String s)
Corresponds to <ant>'s output attribute.
voidsetTarget(String target)
The target to call on the different sub-builds.
voidsetVerbose(boolean on)
Enable/ disable verbose log messages showing when each sub-build path is entered/ exited.

Method Detail

add

public void add(ResourceCollection rc)
Adds a resource collection to the implicit build path.

Parameters: rc the resource collection to add.

Since: Ant 1.7

addConfiguredTarget

public void addConfiguredTarget(Ant.TargetElement t)
Add a target to this Ant invocation.

Parameters: t the TargetElement to add.

Since: Ant 1.7

addDirset

public void addDirset(DirSet set)
Adds a directory set to the implicit build path.

Note that the directories will be added to the build path in no particular order, so if order is significant, one should use a file list instead!

Parameters: set the directory set to add.

addFilelist

public void addFilelist(FileList list)
Adds an ordered file list to the implicit build path.

Note that contrary to file and directory sets, file lists can reference non-existent files or directories!

Parameters: list the file list to add.

addFileset

public void addFileset(FileSet set)
Adds a file set to the implicit build path.

Note that the directories will be added to the build path in no particular order, so if order is significant, one should use a file list instead!

Parameters: set the file set to add.

addProperty

public void addProperty(Property p)
Corresponds to <ant>'s nested <property> element.

Parameters: p the property to pass on explicitly to the sub-build.

addPropertyset

public void addPropertyset(PropertySet ps)
Corresponds to <ant>'s nested <propertyset> element.

Parameters: ps the propertset

addReference

public void addReference(Ant.Reference r)
Corresponds to <ant>'s nested <reference> element.

Parameters: r the reference to pass on explicitly to the sub-build.

createBuildpath

public Path createBuildpath()
Creates a nested build path, and add it to the implicit build path.

Returns: the newly created nested build path.

createBuildpathElement

public Path.PathElement createBuildpathElement()
Creates a nested <buildpathelement>, and add it to the implicit build path.

Returns: the newly created nested build path element.

execute

public void execute()
Runs the various sub-builds.

getDefaultBuildFile

protected String getDefaultBuildFile()
Get the default build file name to use when launching the task.

This function may be overrided by providers of custom ProjectHelper so they can implement easily their sub launcher.

Returns: the name of the default file

Since: Ant 1.8.0

handleErrorFlush

public void handleErrorFlush(String output)
Pass output sent to System.err to the new project.

Parameters: output The error output to log. Should not be null.

Since: Ant 1.6.2

handleErrorOutput

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

Parameters: output The error output to log. Should not be null.

Since: Ant 1.6.2

handleFlush

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

Parameters: output The output to log. Should not be null.

Since: Ant 1.6.2

handleInput

public int handleInput(byte[] buffer, int offset, int length)
Process input into the ant 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: IOException if the data cannot be read

Since: Ant 1.6.2

See Also: (byte[], int, int)

handleOutput

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

Parameters: output a line of output

Since: Ant 1.6.2

setAntfile

public void setAntfile(String antfile)
This method builds the file name to use in conjunction with directories.

Defaults to "build.xml". If genericantfile is set, this attribute is ignored.

Parameters: antfile the short build file name. Defaults to "build.xml".

setBuildpath

public void setBuildpath(Path s)
Set the buildpath to be used to find sub-projects.

Parameters: s an Ant Path object containing the buildpath.

setBuildpathRef

public void setBuildpathRef(Reference r)
Buildpath to use, by reference.

Parameters: r a reference to an Ant Path object containing the buildpath.

setFailonerror

public void setFailonerror(boolean failOnError)
Sets whether to fail with a build exception on error, or go on.

Parameters: failOnError the new value for this boolean flag.

setGenericAntfile

public void setGenericAntfile(File afile)
This method builds a file path to use in conjunction with directories.

Use genericantfile, in order to run the same build file with different basedirs.

If this attribute is set, antfile is ignored.

Parameters: afile (path of the generic ant file, absolute or relative to project base directory)

setInheritall

public void setInheritall(boolean b)
Corresponds to <ant>'s inheritall attribute.

Parameters: b the new value for this boolean flag.

setInheritrefs

public void setInheritrefs(boolean b)
Corresponds to <ant>'s inheritrefs attribute.

Parameters: b the new value for this boolean flag.

setOutput

public void setOutput(String s)
Corresponds to <ant>'s output attribute.

Parameters: s the filename to write the output to.

setTarget

public void setTarget(String target)
The target to call on the different sub-builds. Set to "" to execute the default target.

Parameters: target the target

setVerbose

public void setVerbose(boolean on)
Enable/ disable verbose log messages showing when each sub-build path is entered/ exited. The default value is "false".

Parameters: on true to enable verbose mode, false otherwise (default).