[
https://issues.apache.org/jira/browse/HTTPCLIENT-1602?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14291258#comment-14291258
]
Michael Osipov commented on HTTPCLIENT-1602:
--------------------------------------------
Deducing from your input, the tutorial does not hold completely true and there
is room for improvement in the docs as well as in the exception approach for
5.0. That is why I have added it as fix version.
> 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]
