DOMUtils (Apache Ant API)
Description: declaration: package: org.apache.tools.ant.util, class: DOMUtils

# 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 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