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

Re: SAX: 1998-04-18 pre-release (I/O)

• From: David.Brownell@E... (David Brownell)
• To: jjc@j..., xml-dev@i...
• Date: Sun, 19 Apr 1998 07:53:48 -0700

This makes it an easy call -- "throws IOException".  APIs should never
declare "throws Exception" except maybe in the earliest stage of coming
up with the exception model.  And in this case, "IOException" is how any
code doing I/O will already throw exceptions; no need to for more.

By the way, the names "ByteStream" and "CharacterStream" imply they're
good for writing too.  Far preferable to say "InputStream" and "Reader".
I/O in languages other than Java should obey those languages' rules, as
(and when) the SAX models are translated to them.

- Dave


> Making the read methods on ByteStream and CharacterStream throw
> SAXException seems wrong to me.  In a Java environment I need to be able
> to throw an IOException.  So they should be declared as throwing either
> Exception or IOException.  The approach in InputStreamAdapter of just
> passing through the message from IOExceptions is not acceptable.  An
> application may need to deal with different classes of IOExceptions
> differently, so it needs to be possible to propagate the IOException up
> to Parser.parse.
> 
> James

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: 1998-04-18 pre-release (I/O)
    • From: David Megginson <ak117@f...>

• Prev by Date: Re: SAX: 1998-04-18 pre-release
• Next by Date: Re: SAX: Implied Attributes
• Previous by thread: SAX: 1998-04-18 pre-release
• Next by thread: Re: SAX: 1998-04-18 pre-release (I/O)
• Index(es):
  • Date
  • Thread