Package org.apache.tools.ant.util

Class DOMUtils

java.lang.Object

org.apache.tools.ant.util.DOMUtils

public class DOMUtils
extends Object

Some utility methods for common tasks when building DOM trees in memory.

In this documentation <a> means an Element instance with name a.

Since:

Ant 1.6.3

Method Summary

Modifier and Type	Method	Description
static void	appendCDATA(Element parent, String content)	Adds a nested CDATA section.
static void	appendCDATAElement(Element parent, String name, String content)	Adds a nested CDATA section in a new child element.
static void	appendText(Element parent, String content)	Adds nested text.
static void	appendTextElement(Element parent, String name, String content)	Adds nested text in a new child element.
static Element	createChildElement(Element parent, String name)	Creates a named Element and appends it to the given element, returns it.
static Document	newDocument()	Get a new Document instance,

Methods inherited from class java.lang.Object

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

Method Details

newDocument

public static Document newDocument()

Get a new Document instance,

Returns:

the document.

Since:

Ant 1.6.3

createChildElement

public static Element createChildElement(Element parent,
 String name)

Creates a named Element and appends it to the given element, returns it.

This means

createChildElement(<a>, "b")

creates

 <a>
   <b/>
 </a>
 

and returns <b>.

Parameters:

parent - element that will receive the new element as child.

name - name of the new element.

Returns:

the new element.

Since:

Ant 1.6.3

appendText

public static void appendText(Element parent,
 String content)

Adds nested text.

This means

appendText(<a>, "b")

creates

 <a>b</a>
 

Parameters:

parent - element that will receive the new element as child.

content - text content.

Since:

Ant 1.6.3

appendCDATA

public static void appendCDATA(Element parent,
 String content)

Adds a nested CDATA section.

This means

appendCDATA(<a>, "b")

creates

 <a><[!CDATA[b]]></a>
 

Parameters:

parent - element that will receive the new element as child.

content - text content.

Since:

Ant 1.6.3

appendTextElement

public static void appendTextElement(Element parent,
 String name,
 String content)

Adds nested text in a new child element.

This means

appendTextElement(<a>, "b", "c")

creates

 <a>
   <b>c</b>
 </a>
 

Parameters:

parent - element that will receive the new element as child.

name - of the child element.

content - text content.

Since:

Ant 1.6.3

appendCDATAElement

public static void appendCDATAElement(Element parent,
 String name,
 String content)

Adds a nested CDATA section in a new child element.

This means

appendCDATAElement(<a>, "b", "c")

creates

 <a>
   <b><![CDATA[c]]></b>
 </a>
 

Parameters:

parent - element that will receive the new element as child.

name - of the child element.

content - text content.

Since:

Ant 1.6.3