[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message] SAX2: Parser interface
Here is my current draft of the SAX2 Parser class: public interface Parser { public void setLocale (Locale locale) throws SAXNotSupportedException; public void setFeature (String feature, boolean state) throws SAXNotRecognizedException, SAXNotSupportedException; public boolean getFeature (String feature) throws SAXNotRecognizedException; public void setProperty (String property, Object value) throws SAXNotRecognizedException, SAXNotSupportedException; public Object getProperty (String property) throws SAXNotRecognizedException; public void setEntityResolver (EntityResolver resolver); public void setDTDHandler (DTDHandler handler); public void setNamespaceDeclHandler (NamespaceDeclHandler handler); public void setDocumentHandler (DocumentHandler handler); public void setErrorHandler (ErrorHandler handler); public void setLexicalHandler (LexicalHandler handler) throws SAXNotSupportedException; public void setDeclHandler (DeclHandler handler) throws SAXNotSupportedException; public void parse (String systemId) throws IOException; public void parse (InputSource input) throws IOException; } Notes: 1. LexicalHandler and DeclHandler now have explicit setters, but the parser may throw a SAXNotSupportedException if it does not support them. 2. Extended handler types (for schemas, or what-have-you) can be set using the setProperty method with the appropriate URI identifier. 3. The first arguments to get/setFeature and get/setProperty are fully-qualified URIs (to be included in a future message). Questions: 1. Should there be getters as well as setters for the handlers and the locale? 2. Should the parser be allowed to throw SAXNotSupportedException for NamespaceDeclHandler as well? 3. Should we just use setProperty to set the optional handlers? 4. Should we explicitly allow the systemId argument to parse() to be a relative URI? If so, what should it be relative to? All the best, David -- David Megginson david@m... http://www.megginson.com/ xml-dev: A list for W3C XML Developers. To post, mailto:xml-dev@i... Archived as: http://www.lists.ic.ac.uk/hypermail/xml-dev/ and on CD-ROM/ISBN 981-02-3594-1 To unsubscribe, mailto:majordomo@i... the following message; unsubscribe xml-dev To subscribe to the digests, mailto:majordomo@i... the following message; subscribe xml-dev-digest List coordinator, Henry Rzepa (mailto:rzepa@i...)
|
PURCHASE STYLUS STUDIO ONLINE TODAY!Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced! Download The World's Best XML IDE!Accelerate XML development with our award-winning XML IDE - Download a free trial today! Subscribe in XML format
|