Class XMLFragment

java.lang.Object
org.apache.tools.ant.ProjectComponent
org.apache.tools.ant.util.XMLFragment
All Implemented Interfaces:
java.lang.Cloneable, DynamicElementNS
Direct Known Subclasses:
EchoXML

public class XMLFragment
extends ProjectComponent
implements DynamicElementNS
Use this class as a nested element if you want to get a literal DOM fragment of something nested into your task/type.

This is useful for tasks that want to deal with the "real" XML from the build file instead of objects.

Code heavily influenced by code written by Dominique Devienne.

Since:
Ant 1.7
  • Constructor Details

    • XMLFragment

      public XMLFragment()
      Constructor for XMLFragment object.
  • Method Details

    • getFragment

      public org.w3c.dom.DocumentFragment getFragment()
      Returns:
      the DocumentFragment that corresponds to the nested structure.
    • addText

      public void addText​(java.lang.String s)
      Add nested text, expanding properties as we go
      Parameters:
      s - the text to add
    • createDynamicElement

      public java.lang.Object createDynamicElement​(java.lang.String uri, java.lang.String name, java.lang.String qName)
      Creates a nested element.
      Specified by:
      createDynamicElement in interface DynamicElementNS
      Parameters:
      uri - the uri of the nested element
      name - the localname of the nested element
      qName - the qualified name of the nested element
      Returns:
      an object that the element is applied to