hc-dev mailing list archives

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

    [ https://issues.apache.org/jira/browse/HTTPCLIENT-1602?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14291255#comment-14291255
] 

Oleg Kalnichevski edited comment on HTTPCLIENT-1602 at 1/25/15 8:28 PM:
------------------------------------------------------------------------

Because there is _nothing_ that mandates that it has to be unchecked. Certain HttpException
instances can well be recoverable. They however cannot be recovered from _automatically_ simply
by retrying the request without some exception handling logic.

Oleg


was (Author: olegk):
Because there is _nothing_ that mandates that it has to be unchecked. Certain HttpException
instances can well be recoverable. They however cannot be recovered from _automatically_ simply
by retrying the request with some exception handling logic.

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


Mime
View raw message