Package org.apache.tools.ant.util

# Class XMLFragment

java.lang.Object
org.apache.tools.ant.ProjectComponent
org.apache.tools.ant.util.XMLFragment

All Implemented Interfaces:
  `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

## Nested Class Summary

Nested Classes
Modifier and Type
Class
Description
`class`
`XMLFragment.Child`
An object to handle (recursively) nested elements.

## Field Summary

### Fields inherited from class org.apache.tools.ant.ProjectComponent

`description, location, project`

## Constructor Summary

Constructors
Constructor
Description
`XMLFragment()`
Constructor for XMLFragment object.

## Method Summary

Modifier and Type
Method
Description
`void`
`addText(String s)`
Add nested text, expanding properties as we go
`Object`
`createDynamicElement(String uri, String name, String qName)`
Creates a nested element.
`DocumentFragment`
`getFragment()`

### Methods inherited from class org.apache.tools.ant.ProjectComponent

`clone, getDescription, getLocation, getProject, log, log, setDescription, setLocation, setProject`

### Methods inherited from class java.lang.Object

`equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

## Constructor Details

### XMLFragment

public XMLFragment()
Constructor for XMLFragment object.

## Method Details

### getFragment

public DocumentFragment getFragment()

Returns:
  the DocumentFragment that corresponds to the nested structure.

### addText

public void addText(String s)
Add nested text, expanding properties as we go

Parameters:
  `s` - the text to add

### createDynamicElement

public Object createDynamicElement(String uri, String name, 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