[
https://issues.apache.org/jira/browse/HTTPCLIENT-1602?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14291278#comment-14291278
]
Michael Osipov commented on HTTPCLIENT-1602:
--------------------------------------------
There is no need to be pissed nor to be rude. I have opened this issue with
clear intentions because there is a documentation deficit, bug in terms of
docs, at least for me. Additionally, I haven't seen any efforts that you tried
to understand what I was trying to say or you to depict why this is not a bug
but maybe a doc deficit with room for improvement from your point of view.
I do not might an issue being closed if a I get a reasonable explanation, this
is what I do in other projects, but the opposite is simply neither effective
nor productive.
> 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]
