 |  |
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.
URI: http://xml.org/sax/properties/lexical-handler
Datatype: org.xml.sax.ext.LexicalHandler
Access: Read/write when parsing, read/write when not parsing
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.
URI: http://xml.org/sax/properties/declaration-handler
Datatype: org.xml.sax.ext.DeclHandler
Access: Read/write when parsing, read/write when not parsing
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.
URI: http://xml.org/sax/properties/dom-node
Datatype: org.w3c.dom.Node
Access: Read-only when parsing, read/write when not parsing
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.
URI: http://xml.org/sax/properties/xml-string
Datatype: java.lang.String
Access: Read-only when parsing, read-only when not parsing
|  | |
| B. SAX 2.0 Features and Properties |  | Index |
Copyright © 2002 O'Reilly & Associates. All rights reserved.