org.apache.tools.ant.util

Class DOMUtils

public class DOMUtils extends Object

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

In this documentation <a> means an {@link org.w3c.do.Element Element} instance with name a.

Since: Ant 1.6.3

Method Summary
static voidappendCDATA(Element parent, String content)
Adds a nested CDATA section.
static voidappendCDATAElement(Element parent, String name, String content)
Adds a nested CDATA section in a new child element.
static voidappendText(Element parent, String content)
Adds nested text.
static voidappendTextElement(Element parent, String name, String content)
Adds nested text in a new child element.
static ElementcreateChildElement(Element parent, String name)
Creates a named Element and appends it to the given element, returns it.
static DocumentnewDocument()
Get a new Document instance,

Method Detail

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

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

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

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

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

newDocument

public static Document newDocument()
Get a new Document instance,

Since: Ant 1.6.3

Copyright B) 2000-2007 Apache Software Foundation. All Rights Reserved.