hc-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Michael Osipov (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (HTTPCLIENT-1602) Tutorial claims that HttpException is unrecoverable but the implementation is recoverable
Date Sun, 25 Jan 2015 20:29:35 GMT

    [ 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: dev-unsubscribe@hc.apache.org
For additional commands, e-mail: dev-help@hc.apache.org


Mime
View raw message