Michael Osipov created HTTPCLIENT-1602:
------------------------------------------
Summary: 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.4 Beta1, 4.3.6
Reporter: Michael Osipov
Fix For: 5.0
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]
