[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

Re: SAX: finalising org.sax.xml.Parser

• From: David Megginson <ak117@f...>
• To: James Clark <jjc@j...>
• Date: Wed, 25 Feb 1998 09:10:12 -0500

James Clark writes:

 > XML allows the encoding of an entity being specified by an external
 > transport protocol (see 4.3.3): for example, when an XML document
 > arrives over HTTP with a content type of text/xml, then the
 > encoding specified in the charset parameter is supposed to take
 > precedence over that specified in the document entity by the
 > encoding declaration or by XML's default rules.  So I think we need
 > an additional argument here: a String specifying the name of the
 > encoding to be used for the InputStream, or null if the encoding
 > specified in the document entity should be used.

This is a very good point, as was the suggestion earlier (I don't
remember whose it was) that we rearrange arguments in order of
decreasing importance to the programmer.  With those suggestions in
mind, here's my current take on org.xml.sax.Parser:

  package org.xml.sax;

  public interface Parser {

    public abstract void setEntityHandler (EntityHandler handler);
    public abstract void setDocumentHandler (DocumentHandler handler);
    public abstract void setErrorHandler (ErrorHandler handler);

    public abstract void parse (String systemId, String publicId)
      throws java.lang.Exception;

    public abstract void parse (InputStream input, String encoding,
				String systemId, String publicId)
      throws java.lang.Exception;

  }

I haven't included a setValidate() method yet, partly because I'm not
certain what it would really mean.  If I did

  setValidate(false);

would that simply prevent the reporting of validation errors, or would
it also prohibit the parser from resolving external text entities and
the external DTD subset?


All the best,


David

-- 
David Megginson                 ak117@f...
Microstar Software Ltd.         dmeggins@m...
      http://home.sprynet.com/sprynet/dmeggins/

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/
To (un)subscribe, mailto:majordomo@i... the following message;
(un)subscribe xml-dev
To subscribe to the digests, mailto:majordomo@i... the following message;
subscribe xml-dev-digest
List coordinator, Henry Rzepa (mailto:rzepa@i...)

• Follow-Ups:
  • Re: SAX: finalising org.sax.xml.Parser
    • From: Juergen Modre <jmodre@e...>

• References:
  • SAX: finalising org.sax.xml.Parser
    • From: David Megginson <ak117@f...>
  • Re: SAX: finalising org.sax.xml.Parser
    • From: James Clark <jjc@j...>

• Prev by Date: Re: SAX: org.xml.sax.AttributeMap
• Next by Date: Re: SAX: finalising org.sax.xml.Parser
• Previous by thread: Re: SAX: finalising org.sax.xml.Parser
• Next by thread: Re: SAX: finalising org.sax.xml.Parser
• Index(es):
  • Date
  • Thread