[
https://issues.apache.org/jira/browse/HTTPCLIENT-1602?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14291259#comment-14291259
]
Oleg Kalnichevski commented on HTTPCLIENT-1602:
-----------------------------------------------
Want to improve the tutorial? Just go ahead and improve it. If you feel like
waging the holy war of checked vs unchecked exceptions, feel free to do so on
the dev list. Want to discuss API 5.0 changes? Please by all of means feel free
to do so on the dev list. Please do not raise bug reports for something which
is not a bug.
Oleg
> Tutorial claims that HttpException is unrecoverable but the implementation is
> recoverable
> -----------------------------------------------------------------------------------------
>
> Key: HTTPCLIENT-1602
> URL: https://issues.apache.org/jira/browse/HTTPCLIENT-1602
> Project: HttpComponents HttpClient
> Issue Type: Bug
> Components: Documentation, HttpClient
> Affects Versions: 4.3.6, 4.4 Beta1
> Reporter: Michael Osipov
>
> According to the [chapter
> 1.4|http://hc.apache.org/httpcomponents-client-ga/tutorial/html/fundamentals.html#d5e271]
> of the tutorial the {{HttpException}} and every derived one is
> unrecoverable. If you open up the
> [Javadoc|http://hc.apache.org/httpcomponents-core-ga/httpcore/apidocs/org/apache/http/HttpException.html?is-external=true]
> for, you'll see that is extends {{java.lang.Exception}}. This is wrong,
> unrecoverable exceptions always extend from {{java.lang.RuntimeException}} to
> indicate its nature which is an unchecked exception.
> See
> [this|http://ted-gao.blogspot.de/2013/03/best-practices-in-java-exception.html],
> paragraph *Checked or Unckecked Exception*. It ultimately refers to
> Effective Java, Item 58: Use checked exceptions for recoverable conditions
> and runtime exceptions for programming errors and Item 59: Avoid unnecessary
> use of checked exceptions.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
