Package groovy.xml

# Class DOMBuilder

java.lang.Object
groovy.lang.GroovyObjectSupport
groovy.util.BuilderSupport
groovy.xml.DOMBuilder

All Implemented Interfaces:
  `GroovyObject`

    public class DOMBuilder
    extends BuilderSupport

A helper class for creating a W3C DOM tree

- ## Constructor Summary

  Constructors
  Constructor | Description
  --- | ---
  `DOMBuilder​(DocumentBuilder documentBuilder)` |
  `DOMBuilder​(Document document)` |

- ## Method Summary

  Modifier and Type | Method | Description
  --- | --- | ---
  `protected void` | `appendNamespaceAttributes​(Element element, Map<Object,​Object> attributes)` |
  `protected Document` | `createDocument()` |
  `protected Object` | `createNode​(Object name)` |
  `protected Object` | `createNode​(Object name, Object value)` |
  `protected Object` | `createNode​(Object name, Map attributes)` |
  `protected Object` | `createNode​(Object name, Map attributes, Object value)` |
  `static DOMBuilder` | `newInstance()` |
  `static DOMBuilder` | `newInstance​(boolean validating, boolean namespaceAware)` |
  `static Document` | `parse​(Reader reader)` | Creates a DocumentBuilder and uses it to parse the XML text read from the given reader.
  `static Document` | `parse​(Reader reader, boolean validating, boolean namespaceAware)` | Creates a DocumentBuilder and uses it to parse the XML text read from the given reader, allowing parser validation and namespace awareness to be controlled.
  `static Document` | `parse​(Reader reader, boolean validating, boolean namespaceAware, boolean allowDocTypeDeclaration)` | Creates a DocumentBuilder and uses it to parse the XML text read from the given reader, allowing parser validation, namespace awareness and permission of DOCTYPE declarations to be controlled.
  `Document` | `parseText​(String text)` | A helper method to parse the given text as XML.
  `protected void` | `setParent​(Object parent, Object child)` |

  ### Methods inherited from class groovy.util.BuilderSupport

  `doInvokeMethod, getCurrent, getName, invokeMethod, invokeMethod, nodeCompleted, postNodeCompletion, setClosureDelegate, setCurrent`

  ### Methods inherited from class groovy.lang.GroovyObjectSupport

  `getMetaClass, setMetaClass`

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

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

  ### Methods inherited from interface groovy.lang.GroovyObject

  `getProperty, setProperty`

- ## Constructor Details

  - ### DOMBuilder

    public DOMBuilder​(Document document)

  - ### DOMBuilder

    public DOMBuilder​(DocumentBuilder documentBuilder)

- ## Method Details

  - ### newInstance

    public static DOMBuilder newInstance() throws ParserConfigurationException
    Throws:
      `ParserConfigurationException`

  - ### newInstance

    public static DOMBuilder newInstance​(boolean validating, boolean namespaceAware) throws ParserConfigurationException
    Throws:
      `ParserConfigurationException`

  - ### parse

    public static Document parse​(Reader reader) throws SAXException, IOException, ParserConfigurationException
    Creates a DocumentBuilder and uses it to parse the XML text read from the given reader. A non-validating, namespace aware parser which does not allow DOCTYPE declarations is used.
    Parameters:
      `reader` - the reader to read the XML text from
    Returns:
      the root node of the parsed tree of Nodes
    Throws:
      `SAXException` - Any SAX exception, possibly wrapping another exception.
      `IOException` - An IO exception from the parser, possibly from a byte stream or character stream supplied by the application.
      `ParserConfigurationException` - if a DocumentBuilder cannot be created which satisfies the configuration requested.
    See Also:
      `parse(Reader, boolean, boolean)`

  - ### parse

    public static Document parse​(Reader reader, boolean validating, boolean namespaceAware) throws SAXException, IOException, ParserConfigurationException
    Creates a DocumentBuilder and uses it to parse the XML text read from the given reader, allowing parser validation and namespace awareness to be controlled. Documents are not allowed to contain DOCYTYPE declarations.
    Parameters:
      `reader` - the reader to read the XML text from
      `validating` - whether to validate the XML
      `namespaceAware` - whether the parser should be namespace aware
    Returns:
      the root node of the parsed tree of Nodes
    Throws:
      `SAXException` - Any SAX exception, possibly wrapping another exception.
      `IOException` - An IO exception from the parser, possibly from a byte stream or character stream supplied by the application.
      `ParserConfigurationException` - if a DocumentBuilder cannot be created which satisfies the configuration requested.

  - ### parse

    public static Document parse​(Reader reader, boolean validating, boolean namespaceAware, boolean allowDocTypeDeclaration) throws SAXException, IOException, ParserConfigurationException
    Creates a DocumentBuilder and uses it to parse the XML text read from the given reader, allowing parser validation, namespace awareness and permission of DOCTYPE declarations to be controlled.
    Parameters:
      `reader` - the reader to read the XML text from
      `validating` - whether to validate the XML
      `namespaceAware` - whether the parser should be namespace aware
      `allowDocTypeDeclaration` - whether the parser should allow DOCTYPE declarations
    Returns:
      the root node of the parsed tree of Nodes
    Throws:
      `SAXException` - Any SAX exception, possibly wrapping another exception.
      `IOException` - An IO exception from the parser, possibly from a byte stream or character stream supplied by the application.
      `ParserConfigurationException` - if a DocumentBuilder cannot be created which satisfies the configuration requested.

  - ### parseText

    public Document parseText​(String text) throws SAXException, IOException, ParserConfigurationException
    A helper method to parse the given text as XML.
    Parameters:
      `text` - the XML text to parse
    Returns:
      the root node of the parsed tree of Nodes
    Throws:
      `SAXException` - Any SAX exception, possibly wrapping another exception.
      `IOException` - An IO exception from the parser, possibly from a byte stream or character stream supplied by the application.
      `ParserConfigurationException` - if a DocumentBuilder cannot be created which satisfies the configuration requested.
    See Also:
      `parse(Reader)`

  - ### setParent

    protected void setParent​(Object parent, Object child)
    Specified by:
      `setParent` in class `BuilderSupport`

  - ### createNode

    protected Object createNode​(Object name)
    Specified by:
      `createNode` in class `BuilderSupport`

  - ### createDocument

    protected Document createDocument()

  - ### createNode

    protected Object createNode​(Object name, Object value)
    Specified by:
      `createNode` in class `BuilderSupport`

  - ### createNode

    protected Object createNode​(Object name, Map attributes, Object value)
    Specified by:
      `createNode` in class `BuilderSupport`

  - ### createNode

    protected Object createNode​(Object name, Map attributes)
    Specified by:
      `createNode` in class `BuilderSupport`

  - ### appendNamespaceAttributes

    protected void appendNamespaceAttributes​(Element element, Map<Object,​Object> attributes)