[jdom-interest] Re: Exception documentation

[Elliotte Rusty Harold]

At 2:20 AM -0700 4/30/02, Joseph Bowbeer wrote:
>Hallvard Trætteberg writes:
>
>>  the question Elliotte raises is whether the throws clause
>>  should indicate which subclass of JDOMException that
>>  is actually raised, instead of the general JDOMException
>

Actually that's a different suggestion and a different thread.

>Oh.  Then I like that suggestion, too.
>
>When Elliotte used the term "runtime exception" I thought he was referring
>to exceptions derived from RuntimeException, which are unchecked.
>

I was.

>We may need to think about this again in the context of the spec.  For
>example, are there some cases where we would specify a blanket
>"JDOMException" but use specific JDOMException subclasses in the reference
>implementation?
>

More likely, I think there are cases where we need to both specify 
and use a more specific subclass of JDOMException. For instance, I've 
already proposed splitting out well-formedness errors from validity 
errors. There are probably other cases where it makes sense to use 
more specific exceptions.
-- 

+-----------------------+------------------------+-------------------+
| Elliotte Rusty Harold | elharo at metalab.unc.edu | Writer/Programmer |
+-----------------------+------------------------+-------------------+
|          The XML Bible, 2nd Edition (Hungry Minds, 2001)           |
|             http://www.cafeconleche.org/books/bible2/              |
|   http://www.amazon.com/exec/obidos/ISBN=0764547607/cafeaulaitA/   |
+----------------------------------+---------------------------------+
|  Read Cafe au Lait for Java News:  http://www.cafeaulait.org/      |
|  Read Cafe con Leche for XML News: http://www.cafeconleche.org/    |
+----------------------------------+---------------------------------+