⇒ Index (Frames) |  ⇒ Index (No Frames) |  ⇒ Package |  ⇒ Package Tree |  ⇒ Full Tree 
gnu.xml.util

Class DomParser

java.lang.Object
|
+--gnu.xml.util.DomParser

All Implemented Interfaces:
XMLReader


public final class DomParser
extends java.lang.Object
implements XMLReader

This parser emits SAX2 parsing events as it traverses a DOM tree, using any conformant implementation of DOM. It exposes all SAX1 features, and the following SAX2 features and properties (as identified by standard URIs which are not fully provided here). Note that if a Level 1 DOM implementation is given, then this behaves as if namespaces were disabled, and namespace prefixes were enabled.
NameNotes
Features ... URL prefix is http://xml.org/sax/features/
(URL)/external-general-entitiesfalse (does no parsing)
(URL)/external-parameter-entitiesfalse (does no parsing)
(URL)/namespacesValue is fixed at true
(URL)/namespace-prefixesValue is settable, defaulting to false (xmlns attributes hidden, and names aren't prefixed)
(URL)/string-interningValue is fixed at false (DOM provides no guarantees as to interning)
(URL)/validationfalse (does no parsing)
(URL)/lexical-handler/parameter-entitiesfalse (DOM doesn't do parameter entities)
Properties ... URL prefix is http://xml.org/sax/properties/
(URL)/dom-nodeThis property may be set before parsing to hold a DOM Document node; any arguments given to parse methods are ignored. When retrieved during a parse, this value contains the "current" DOM node.
(URL)/declaration-handlerA declaration handler may be provided. Declaration of external general entities is exposed, but not parameter entities; none of the entity names reported here will begin with "%".
(URL)/lexical-handlerA lexical handler may be provided. While the start and end of any external subset are reported, expansion of other parameter entities (e.g. inside attribute list declarations) is not exposed. Expansion of general entities within attributes is also not exposed (see below).

The consequences of modifying a DOM document tree as it is being walked by this "parser" are unspecified; don't do it!

Author:
David Brownell

Constructor Summary

DomParser()

Constructs an unitialized SAX2 parser.

DomParser(Node node)

Constructs an SAX2 parser initialized to traverse the specified DOM tree.

Method Summary

ContentHandler

getContentHandler()

SAX2: Returns the object used to report the logical content of an XML document.

DTDHandler

getDTDHandler()

SAX2: Returns the object used to process declarations related to notations and unparsed entities.

EntityResolver

getEntityResolver()

SAX2: Returns the object used when resolving external entities during parsing (both general and parameter entities).

ErrorHandler

getErrorHandler()

SAX2: Returns the object used to receive callbacks for XML errors of all levels (fatal, nonfatal, warning).

boolean

getFeature(java.lang.String name)

SAX2: Tells whether this parser supports the specified feature.

java.lang.Object

getProperty(java.lang.String name)

SAX2: Returns the specified property.

void

parse(java.lang.String uri)

SAX1: Parses the previously provided DOM document (the input parameter is ignored).

void

parse(InputSource input)

SAX1: Parses the previously provided DOM document (the input parameter is ignored).

void

setContentHandler(ContentHandler handler)

SAX2: Assigns the object used to report the logical content of an XML document.

void

setDTDHandler(DTDHandler handler)

SAX1: Provides an object which may be used to intercept declarations related to notations and unparsed entities.

void

setEntityResolver(EntityResolver resolver)

SAX1: Provides an object which may be used when resolving external entities during parsing (both general and parameter entities).

void

setErrorHandler(ErrorHandler handler)

SAX1: Provides an object which receives callbacks for XML errors of all levels (fatal, nonfatal, warning).

void

setFeature(java.lang.String name, boolean state)

SAX2: Sets the state of features supported in this parser.

void

setLocale(java.util.Locale locale)

SAX1: Identifies the locale which the parser should use for the diagnostics it provides.

void

setProperty(java.lang.String name, java.lang.Object state)

SAX2: Assigns the specified property.

Constructor Details

DomParser

public DomParser()

Constructs an unitialized SAX2 parser.


DomParser

public DomParser(Node node)

Constructs an SAX2 parser initialized to traverse the specified DOM tree. If the node is a document, the startDocument() and endDocument() calls bracket the calls exposing children.

Parameters:
node

Method Details

getContentHandler

public ContentHandler getContentHandler()

SAX2: Returns the object used to report the logical content of an XML document.


getDTDHandler

public DTDHandler getDTDHandler()

SAX2: Returns the object used to process declarations related to notations and unparsed entities.


getEntityResolver

public EntityResolver getEntityResolver()

SAX2: Returns the object used when resolving external entities during parsing (both general and parameter entities).


getErrorHandler

public ErrorHandler getErrorHandler()

SAX2: Returns the object used to receive callbacks for XML errors of all levels (fatal, nonfatal, warning).


getFeature

public boolean getFeature(java.lang.String name)

SAX2: Tells whether this parser supports the specified feature.

Parameters:
name

getProperty

public Object getProperty(java.lang.String name)

SAX2: Returns the specified property. At this time only the declaration and lexical handlers, and current the "DOM" node, are supported.

Parameters:
name

parse

public void parse(java.lang.String uri)

SAX1: Parses the previously provided DOM document (the input parameter is ignored). When this returns, that same document may be parsed again without needing a "reset".

Parameters:
uri - ignored (pass an empty string)
Throws:
SAXException - as defined in the specification for org.xml.sax.Parser.parse()

parse

public void parse(InputSource input)

SAX1: Parses the previously provided DOM document (the input parameter is ignored). When this returns, that same document may be parsed again without needing a "reset".

Parameters:
input - ignored
Throws:
SAXException - as defined in the specification for org.xml.sax.Parser.parse()

setContentHandler

public void setContentHandler(ContentHandler handler)

SAX2: Assigns the object used to report the logical content of an XML document.

Parameters:
handler

setDTDHandler

public void setDTDHandler(DTDHandler handler)

SAX1: Provides an object which may be used to intercept declarations related to notations and unparsed entities.

Parameters:
handler

setEntityResolver

public void setEntityResolver(EntityResolver resolver)

SAX1: Provides an object which may be used when resolving external entities during parsing (both general and parameter entities).

Parameters:
resolver

setErrorHandler

public void setErrorHandler(ErrorHandler handler)

SAX1: Provides an object which receives callbacks for XML errors of all levels (fatal, nonfatal, warning).

Parameters:
handler

setFeature

public void setFeature(java.lang.String name, boolean state)

SAX2: Sets the state of features supported in this parser. Only the namespace support features are mutable.

Parameters:
name
state

setLocale

public void setLocale(java.util.Locale locale)

SAX1: Identifies the locale which the parser should use for the diagnostics it provides.

Parameters:
locale
Throws:
SAXException - as defined in the specification for org.xml.sax.Parser.setLocale()

setProperty

public void setProperty(java.lang.String name, java.lang.Object state)

SAX2: Assigns the specified property. At this time only declaration and lexical handlers, and the initial DOM document, are supported. These must not be changed to values of the wrong type. Like SAX1 handlers, these handlers may be changed at any time. Like SAX1 input source or document URI, the initial DOM document may not be changed during a parse.

Parameters:
name
state