## org.apache.xerces.jaxp
Class DocumentBuilderImpl

    java.lang.Object
      |
      +--javax.xml.parsers.DocumentBuilder
            |
            +--org.apache.xerces.jaxp.DocumentBuilderImpl

All Implemented Interfaces:
  JAXPConstants

public class DocumentBuilderImpl
extends javax.xml.parsers.DocumentBuilder
implements JAXPConstants

Version:
  $Id: DocumentBuilderImpl.java 520058 2007-03-19 19:33:53Z mrglavas $
Author:
  Rajiv Mordani, Edwin Goei

Fields inherited from interface org.apache.xerces.jaxp.JAXPConstants
`JAXP_SCHEMA_LANGUAGE, JAXP_SCHEMA_SOURCE, W3C_XML_SCHEMA`

Method Summary
`org.w3c.dom.DOMImplementation` `getDOMImplementation()` Obtain an instance of a `DOMImplementation` object.
`javax.xml.validation.Schema` `getSchema()` Get a reference to the the `Schema` being used by the XML processor.
`boolean` `isNamespaceAware()` Indicates whether or not this parser is configured to understand namespaces.
`boolean` `isValidating()` Indicates whether or not this parser is configured to validate XML documents.
`boolean` `isXIncludeAware()` Gets the XInclude processing mode for this parser
`org.w3c.dom.Document` `newDocument()` Non-preferred: use the getDOMImplementation() method instead of this one to get a DOM Level 2 DOMImplementation object and then use DOM Level 2 methods to create a DOM Document object.
`org.w3c.dom.Document` `parse(org.xml.sax.InputSource is)` Parse the content of the given input source as an XML document and return a new DOM `Document` object.
`void` `reset()` Reset this `DocumentBuilder` to its original configuration.
`void` `setEntityResolver(org.xml.sax.EntityResolver er)` Specify the `EntityResolver` to be used to resolve entities present in the XML document to be parsed.
`void` `setErrorHandler(org.xml.sax.ErrorHandler eh)` Specify the `ErrorHandler` to be used by the parser.

Methods inherited from class javax.xml.parsers.DocumentBuilder
`parse, parse, parse, parse`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Method Detail

### newDocument

    public org.w3c.dom.Document newDocument()

  Non-preferred: use the getDOMImplementation() method instead of this one to get a DOM Level 2 DOMImplementation object and then use DOM Level 2 methods to create a DOM Document object.
  Overrides:
    `newDocument` in class `javax.xml.parsers.DocumentBuilder`
  Following copied from class: `javax.xml.parsers.DocumentBuilder`
  Returns:
    A new instance of a DOM Document object.

### getDOMImplementation

    public org.w3c.dom.DOMImplementation getDOMImplementation()

  Description copied from class: `javax.xml.parsers.DocumentBuilder`
  Obtain an instance of a `DOMImplementation` object.
  Overrides:
    `getDOMImplementation` in class `javax.xml.parsers.DocumentBuilder`
  Following copied from class: `javax.xml.parsers.DocumentBuilder`
  Returns:
    A new instance of a `DOMImplementation`.

### parse

    public org.w3c.dom.Document parse(org.xml.sax.InputSource is)
                               throws org.xml.sax.SAXException,
                                      java.io.IOException

  Description copied from class: `javax.xml.parsers.DocumentBuilder`
  Parse the content of the given input source as an XML document and return a new DOM `Document` object. An `IllegalArgumentException` is thrown if the `InputSource` is `null` null.
  Overrides:
    `parse` in class `javax.xml.parsers.DocumentBuilder`
  Following copied from class: `javax.xml.parsers.DocumentBuilder`
  Parameters:
    `is` - InputSource containing the content to be parsed.
  Returns:
    A new DOM Document object.
  Throws:
    `java.io.IOException` - If any IO errors occur.
    `org.xml.sax.SAXException` - If any parse errors occur.
  See Also:
    `DocumentHandler`

### isNamespaceAware

    public boolean isNamespaceAware()

  Description copied from class: `javax.xml.parsers.DocumentBuilder`
  Indicates whether or not this parser is configured to understand namespaces.
  Overrides:
    `isNamespaceAware` in class `javax.xml.parsers.DocumentBuilder`
  Following copied from class: `javax.xml.parsers.DocumentBuilder`
  Returns:
    true if this parser is configured to understand namespaces; false otherwise.

### isValidating

    public boolean isValidating()

  Description copied from class: `javax.xml.parsers.DocumentBuilder`
  Indicates whether or not this parser is configured to validate XML documents.
  Overrides:
    `isValidating` in class `javax.xml.parsers.DocumentBuilder`
  Following copied from class: `javax.xml.parsers.DocumentBuilder`
  Returns:
    true if this parser is configured to validate XML documents; false otherwise.

### isXIncludeAware

    public boolean isXIncludeAware()

  Gets the XInclude processing mode for this parser
  Overrides:
    `isXIncludeAware` in class `javax.xml.parsers.DocumentBuilder`
  Returns:
    the state of XInclude processing mode

### setEntityResolver

    public void setEntityResolver(org.xml.sax.EntityResolver er)

  Description copied from class: `javax.xml.parsers.DocumentBuilder`
  Specify the `EntityResolver` to be used to resolve entities present in the XML document to be parsed. Setting this to `null` will result in the underlying implementation using it's own default implementation and behavior.
  Overrides:
    `setEntityResolver` in class `javax.xml.parsers.DocumentBuilder`
  Following copied from class: `javax.xml.parsers.DocumentBuilder`
  Parameters:
    `er` - The `EntityResolver` to be used to resolve entities present in the XML document to be parsed.

### setErrorHandler

    public void setErrorHandler(org.xml.sax.ErrorHandler eh)

  Description copied from class: `javax.xml.parsers.DocumentBuilder`
  Specify the `ErrorHandler` to be used by the parser. Setting this to `null` will result in the underlying implementation using it's own default implementation and behavior.
  Overrides:
    `setErrorHandler` in class `javax.xml.parsers.DocumentBuilder`
  Following copied from class: `javax.xml.parsers.DocumentBuilder`
  Parameters:
    `eh` - The `ErrorHandler` to be used by the parser.

### getSchema

    public javax.xml.validation.Schema getSchema()

  Description copied from class: `javax.xml.parsers.DocumentBuilder`

  Get a reference to the the `Schema` being used by the XML processor.

  If no schema is being used, `null` is returned.

  Overrides:
    `getSchema` in class `javax.xml.parsers.DocumentBuilder`
  Following copied from class: `javax.xml.parsers.DocumentBuilder`
  Returns:
    `Schema` being used or `null` if none in use
  Throws:
    `UnsupportedOperationException` - For backward compatibility, when implementations for earlier versions of JAXP is used, this exception will be thrown.

### reset

    public void reset()

  Description copied from class: `javax.xml.parsers.DocumentBuilder`

  Reset this `DocumentBuilder` to its original configuration.

  `DocumentBuilder` is reset to the same state as when it was created with `DocumentBuilderFactory.newDocumentBuilder()`. `reset()` is designed to allow the reuse of existing `DocumentBuilder`s thus saving resources associated with the creation of new `DocumentBuilder`s.

  The reset `DocumentBuilder` is not guaranteed to have the same `EntityResolver` or `ErrorHandler` `Object`s, e.g. `Object.equals(Object obj)`. It is guaranteed to have a functionally equal `EntityResolver` and `ErrorHandler`.

  Overrides:
    `reset` in class `javax.xml.parsers.DocumentBuilder`

Copyright © 1999-2007 The Apache Software Foundation. All Rights Reserved.