XOM API for Processing XML with Java

[John Cowan <cowan AT ccil.org>]

Elliotte Rusty Harold scripsit:

> The mutator methods are public, not protected. Does that change your 
> opinion on this?

No, that was a mere slip.

> I'm not sure whether the @throws clause should 
> really be used to document every runtime exception an overriding 
> method may plausibly throw. 

Fair enough, but I do think the caller should be prepared to get any
kind of SAXException, because the caller shouldn't have to know that
a subclass is actually answering the method.  Documenting the methods
as returning SAXException rather than a more specific exception serves
as psychological preparation for that.

-- 
John Cowan  jcowan AT reutershealth.com  http://www.ccil.org/~cowan
Does anybody want any flotsam? / I've gotsam.
Does anybody want any jetsam? / I can getsam.
        --Ogden Nash, No Doctors Today, Thank You