You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@commons.apache.org by "Gary D. Gregory (Jira)" <ji...@apache.org> on 2022/04/15 17:03:00 UTC

[jira] [Commented] (POOL-269) Specialize useless throws Exception in method signatures

    [ https://issues.apache.org/jira/browse/POOL-269?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17522899#comment-17522899 ] 

Gary D. Gregory commented on POOL-269:
--------------------------------------

I agree that we can keep binary compatibility since this is all generics and exceptions in method signatures. Source compatibility is not possible obviously. I have an experiment in progress.

> Specialize useless throws Exception in method signatures
> --------------------------------------------------------
>
>                 Key: POOL-269
>                 URL: https://issues.apache.org/jira/browse/POOL-269
>             Project: Commons Pool
>          Issue Type: Improvement
>    Affects Versions: 2.2
>            Reporter: Michael Osipov
>            Priority: Major
>             Fix For: 3.0
>
>
> Too many methods say {{throws Exception}} in their signature. This is neither helpful nor good API design. You never know what the exception is and where it came from.
> An exception translation pattern has to be applied to make code usable, e.g., like the Spring project does or Maven with {{BuildException}}.
> Unfortunately, this ugly practive has prevailed in several Apache projects like Lucene.



--
This message was sent by Atlassian Jira
(v8.20.1#820001)