SAX2: DeclHandler

[David Megginson]

Here's the DeclHandler that we designed for SAX2alpha, with
IOException replacing SAXException in the throws clauses:

  public interface DeclHandler
  {
    public void elementDecl (String name, String model) throws IOException;
    public void attributeDecl (String eName, String name, String type,
			       String valueDefault, String value)
      throws IOException;
    public void internalEntityDecl (String name, String value)
      throws IOException;

    public void externalEntityDecl (String name, String publicId,
				    String systemId)
      throws IOException;
  }

Notes:

1. Unparsed entity and notation declarations are reported by the (now
   confusingly-named) DTDHandler.  The distinction is that the XML 1.0 
   REC requires parsers to report unparsed-entity and notation
   declarations, but not other DTD-based declarations.

2. The model argument in elementDecl is a normalized string
   representation of a content model.  It's not ideal, but everyone
   agreed last time that it was workable.

This interface seems hopelessly anachronistic, and I'm not willing to
invest too much time in it -- after all, while DTDs are useful in
themselves, the declarations should hardly form part of downstream
processing -- but enough people want it that it's useful to include it
as an optional feature.


All the best,


David

-- 
David Megginson                 david at megginson.com
           http://www.megginson.com/

xml-dev: A list for W3C XML Developers. To post, mailto:xml-dev at ic.ac.uk
Archived as: http://www.lists.ic.ac.uk/hypermail/xml-dev/ and on CD-ROM/ISBN 981-02-3594-1
To unsubscribe, mailto:majordomo at ic.ac.uk the following message;
unsubscribe xml-dev
To subscribe to the digests, mailto:majordomo at ic.ac.uk the following message;
subscribe xml-dev-digest
List coordinator, Henry Rzepa (mailto:rzepa at ic.ac.uk)