hc-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sebb <seb...@gmail.com>
Subject Re: Unthrown Exceptions in NIO
Date Wed, 25 Feb 2009 13:20:09 GMT
On 25/02/2009, Oleg Kalnichevski <olegk@apache.org> wrote:
> sebb wrote:
>
> > There are a few Eclipse warnings of unthrown Exceptions in NIO, for
> example:
> >
> > SSLIOSession.inboundTransport() throws IOException
> >
> > which does not actually throw any Exceptions.
> >
> > Should these be removed?
> > Documented?
> > @Suppressed?
> >
> >
>
>  I do not think 'throws' declaration can be removed without breaking API
> compatibility. One possibility could be to copy the method, remove 'throws',
> change the original method to call the new one, and deprecate the original
> method. I am not sure it is worth the trouble, so @Suppressed should be the
> easiest work-around.

Or adding @throws to the Javadoc might be better, as one can document
that it is not actually thrown, e.g.

 * @throws IOException - not thrown currently

>  Cheers
>
>  Oleg
>
>
> > S///
> >
> >
> ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@hc.apache.org
> > For additional commands, e-mail: dev-help@hc.apache.org
> >
> >
>
>
> ---------------------------------------------------------------------
>  To unsubscribe, e-mail: dev-unsubscribe@hc.apache.org
>  For additional commands, e-mail: dev-help@hc.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@hc.apache.org
For additional commands, e-mail: dev-help@hc.apache.org


Mime
View raw message