groovy.util
Class AntBuilder

java.lang.Object
  groovy.lang.GroovyObjectSupport
      groovy.util.BuilderSupport
          groovy.util.AntBuilder

All Implemented Interfaces:

GroovyObject

public class AntBuilder
extends BuilderSupport

Allows Ant tasks to be used with GroovyMarkup. Requires the ant.jar in your classpath which will happen automatically if you are using the Groovy distribution but will be up to you to organize if you are embedding Groovy. If you wish to use the optional tasks you will need to add one or more additional jars from the ant distribution to your classpath.

Version:

$Revision: 17931 $

Author:

James Strachan, Dierk Koenig (dk), Marc Guillemot

Constructor Summary

AntBuilder()

AntBuilder(Project project)

AntBuilder(Project project, Target owningTarget)

AntBuilder(Task parentTask)

Method Summary

protected static Attributes	buildAttributes(Map attributes) Builds an Attributes from a Map
protected Object	createNode(Object tagName)
protected Object	createNode(Object name, Map attributes)
protected Object	createNode(Object name, Map attributes, Object value)
protected Object	createNode(Object name, Object value)
protected static Project	createProject()
protected Object	doInvokeMethod(String methodName, Object name, Object args) We don't want to return the node as created in createNode(Object, Map, Object) but the one made ready by nodeCompleted(Object, Object)
Project	getAntProject()
AntXMLContext	getAntXmlContext() Gets the xml context of Ant used while creating tasks
Project	getProject() # Gets the Ant project in which the tasks are executed
protected void	nodeCompleted(Object parent, Object node) Determines, when the ANT Task that is represented by the "node" should perform.
protected void	setParent(Object parent, Object child)
protected void	setText(Object task, String text)

Methods inherited from class groovy.util.BuilderSupport

getCurrent, getName, invokeMethod, invokeMethod, postNodeCompletion, setClosureDelegate, setCurrent

Methods inherited from class groovy.lang.GroovyObjectSupport

getMetaClass, getProperty, setMetaClass, setProperty

Methods inherited from class java.lang.Object

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

Constructor Detail

AntBuilder

public AntBuilder()

AntBuilder

public AntBuilder(Project project)

AntBuilder

public AntBuilder(Project project,
                  Target owningTarget)

AntBuilder

public AntBuilder(Task parentTask)

Method Detail

getProject

public Project getProject()

# Gets the Ant project in which the tasks are executed

Returns:

the project

getAntXmlContext

public AntXMLContext getAntXmlContext()

Gets the xml context of Ant used while creating tasks

Returns:

the Ant xml context

createProject

protected static Project createProject()

Returns:

Factory method to create new Project instances

setParent

protected void setParent(Object parent,
                         Object child)

Specified by:

setParent in class BuilderSupport

doInvokeMethod

protected Object doInvokeMethod(String methodName,
                                Object name,
                                Object args)

We don't want to return the node as created in createNode(Object, Map, Object) but the one made ready by nodeCompleted(Object, Object)

Overrides:

doInvokeMethod in class BuilderSupport

See Also:

BuilderSupport.doInvokeMethod(java.lang.String, java.lang.Object, java.lang.Object)

nodeCompleted

protected void nodeCompleted(Object parent,
                             Object node)

Determines, when the ANT Task that is represented by the "node" should perform. Node must be an ANT Task or no "perform" is called. If node is an ANT Task, it performs right after complete construction. If node is nested in a TaskContainer, calling "perform" is delegated to that TaskContainer.

Overrides:

nodeCompleted in class BuilderSupport

Parameters:

parent - note: null when node is root

node - the node that now has all its children applied

createNode

protected Object createNode(Object tagName)

Specified by:

createNode in class BuilderSupport

createNode

protected Object createNode(Object name,
                            Object value)

Specified by:

createNode in class BuilderSupport

createNode

protected Object createNode(Object name,
                            Map attributes,
                            Object value)

Specified by:

createNode in class BuilderSupport

buildAttributes

protected static Attributes buildAttributes(Map attributes)

Builds an Attributes from a Map

Parameters:

attributes - the attributes to wrap

Returns:

the wrapped attributes

createNode

protected Object createNode(Object name,
                            Map attributes)

Specified by:

createNode in class BuilderSupport

setText

protected void setText(Object task,
                       String text)

getAntProject

public Project getAntProject()