[ 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:26 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 with some exception handling logic. Oleg was (Author: olegk): Because there is _nothing_ that mandates that it has to be. 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-unsubscr...@hc.apache.org For additional commands, e-mail: dev-h...@hc.apache.org