B.2. Core Properties
Properties provide a way to deal with objects used in the parsing process, particularly when dealing with handlers such as LexicalHandler and DeclHandler that are not in the core set of SAX 2.0 handlers (EntityResolver, DTDHandler, ContentHandler, and ErrorHandler). Any property can be read-only or read/write; features also may be modifiable only when parsing is occurring, or only when parsing is not occurring.
B.2.1. Lexical Handler
This property allows the setting and retrieval of a LexicalHandler implementation to be used for handling of comments and DTD references within an XML document.
B.2.2. Declaration Handler
This property allows the setting and retrieval of a DeclHandler implementation to be used for handling of constraints within a DTD.
B.2.3. DOM Node
When parsing is occurring, this property retrieves the current DOM node (if a DOM iterator is being used). When parsing is not occurring, it retrieves the root DOM node. Most of the parsers I used in testing for this book did not support this property except in very special cases; I wouldn't rely on it providing useful information in the general case.
B.2.4. Literal (XML) String
This retrieves the literal characters in the XML document that triggered the event in process when this property is used. Like the DOM node feature, I found little use and little support for this property. Don't depend on it, particularly across parsers.
Copyright © 2002 O'Reilly & Associates. All rights reserved.