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,

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


Copyright 2000-2005 Apache Software Foundation. All Rights Reserved.