Class DocumentBuilder

protected DocumentBuilder()

The basic constructor. Object is special, because it has no superclass, so there is no call to super().

public abstract DOMImplementation getDOMImplementation()

Returns the DOM implementation.

public Schema getSchema()

Returns the schema in use by the XML processor.

public abstract boolean isNamespaceAware()

Indicates whether this document builder is XML Namespace aware.

public abstract boolean isValidating()

Indicates whether this document builder will validate its input.

public boolean isXIncludeAware()

Returns the XInclude processing mode in use by the parser.

public abstract Document newDocument()

Creates a new, empty DOM Document. To create a document with a root element and optional doctype, use the DOMImplementation instead.

See Also:

DOMImplementation.createDocument(String,String,DocumentType)

public Document parse(File f)
            throws SAXException,
                   IOException

Parse the specified file and return a DOM Document.

Parameters:

f - the XML file

Throws:

IllegalArgumentException - if the file is null

public Document parse(InputStream is)
            throws SAXException,
                   IOException

Parse the specified input stream and return a DOM Document. Prefer the version of this method that specifies a system ID, in order to resolve external references correctly.

Parameters:

is - an XML input stream

Throws:

IllegalArgumentException - if the input stream is null

public Document parse(InputStream is,
                      String systemId)
            throws SAXException,
                   IOException

Parse the specified input stream and return a DOM Document.

Parameters:

is - an XML input stream

systemId - the system ID of the XML document

Throws:

IllegalArgumentException - if the input stream is null

public Document parse(String uri)
            throws SAXException,
                   IOException

Parse the content of the specified URI and return a DOM Document.

Parameters:

uri - an XML system ID

Throws:

IllegalArgumentException - if the URI is null

public abstract Document parse(InputSource source)
            throws SAXException,
                   IOException

Parse the specified input source and return a DOM Document.

Parameters:

source - the input source

Throws:

IllegalArgumentException - if the input source is null

public void reset()

Reset this document builder to its original configuration.

Since:

1.3

public abstract void setEntityResolver(EntityResolver er)

Sets the SAX entity resolver callback used to resolve external entities in the XML document(s) to parse.

Parameters:

er - an entity resolver

public abstract void setErrorHandler(ErrorHandler eh)

Sets the SAX error handler callback used to report parsing errors.

Parameters:

eh - the error handler