org.apache.tools.ant.util

Class XMLFragment

public class XMLFragment extends ProjectComponent implements DynamicElementNS

Use this class as a nested element if you want to get a literal DOM fragment of something nested into your task/type.

This is useful for tasks that want to deal with the "real" XML from the build file instead of objects.

Code heavily influenced by code written by Dominique Devienne.

Since: Ant 1.7

Nested Class Summary
classXMLFragment.Child
An object to handle (recursively) nested elements.
Constructor Summary
XMLFragment()
Constructor for XMLFragment object.
Method Summary
voidaddText(String s)
Add nested text, expanding properties as we go
ObjectcreateDynamicElement(String uri, String name, String qName)
Creates a nested element.
DocumentFragmentgetFragment()

Constructor Detail

XMLFragment

public XMLFragment()
Constructor for XMLFragment object.

Method Detail

addText

public void addText(String s)
Add nested text, expanding properties as we go

Parameters: s the text to add

createDynamicElement

public Object createDynamicElement(String uri, String name, String qName)
Creates a nested element.

Parameters: uri the uri of the nested element name the localname of the nested element qName the qualified name of the nested element

Returns: an object that the element is applied to

getFragment

public DocumentFragment getFragment()

Returns: the DocumentFragment that corresponds to the nested structure.