org.apache.tools.ant.util
Class DOMUtils

java.lang.Object
  org.apache.tools.ant.util.DOMUtils

public class DOMUtils
extends java.lang.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

Constructor Summary

DOMUtils()

Method Summary

static void	appendCDATA(org.w3c.dom.Element parent, java.lang.String content) Adds a nested CDATA section.
static void	appendCDATAElement(org.w3c.dom.Element parent, java.lang.String name, java.lang.String content) Adds a nested CDATA section in a new child element.
static void	appendText(org.w3c.dom.Element parent, java.lang.String content) Adds nested text.
static void	appendTextElement(org.w3c.dom.Element parent, java.lang.String name, java.lang.String content) Adds nested text in a new child element.
static org.w3c.dom.Element	createChildElement(org.w3c.dom.Element parent, java.lang.String name) Creates a named Element and appends it to the given element, returns it.
static org.w3c.dom.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

Constructor Detail

DOMUtils

public DOMUtils()

Method Detail

newDocument

public static org.w3c.dom.Document newDocument()

Get a new Document instance,

Returns:

the document.

Since:

Ant 1.6.3

createChildElement

public static org.w3c.dom.Element createChildElement(org.w3c.dom.Element parent,
                                                     java.lang.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(org.w3c.dom.Element parent,
                              java.lang.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(org.w3c.dom.Element parent,
                               java.lang.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(org.w3c.dom.Element parent,
                                     java.lang.String name,
                                     java.lang.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(org.w3c.dom.Element parent,
                                      java.lang.String name,
                                      java.lang.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