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] [Commented] (HTTPCLIENT-1603) ClientProtocolException contradicts tutorial statement in chapter 1.4
Date Tue, 27 Jan 2015 21:54:34 GMT

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

Oleg Kalnichevski commented on HTTPCLIENT-1603:
-----------------------------------------------

Believe it or not, it was done for convenience of people migrating off HC 2.x and HC 3.x,
which basically made no distinction between transport and protocol errors, where everything
was a frigging mess and all exceptions were based on IOException. Please also bear in mind
that _a lot_ of HttpClient design decisions were made while Java 1.3 was a novelty and Bruce
Willis still had scalp hair.

Oleg


> ClientProtocolException contradicts tutorial statement in chapter 1.4
> ---------------------------------------------------------------------
>
>                 Key: HTTPCLIENT-1603
>                 URL: https://issues.apache.org/jira/browse/HTTPCLIENT-1603
>             Project: HttpComponents HttpClient
>          Issue Type: Bug
>          Components: Documentation, HttpClient
>    Affects Versions: 4.3.6, 4.4 Beta1
>            Reporter: Michael Osipov
>            Priority: Minor
>             Fix For: 4.4 Final
>
>
> [Chapter 1.4|http://hc.apache.org/httpcomponents-client-ga/tutorial/html/fundamentals.html#d5e271]
says: "HttpClient can throw two types of exceptions: {{java.io.IOException}} in case of an
I/O failure such as socket timeout or an socket reset and {{HttpException}} that signals an
HTTP failure such as a violation of the HTTP protocol. Usually I/O errors are considered non-fatal
and recoverable, whereas HTTP protocol errors are considered fatal and cannot be automatically
recovered from."
> The [Javadoc|http://hc.apache.org/httpcomponents-client-ga/httpclient/apidocs/org/apache/http/client/ClientProtocolException.html]
of {{ClientProtocolException}} says: "Signals an error in the HTTP protocol." Given the definition
established in the tutorial, either one is incorrect. Either {{ClientProtocolException}} must
derive from {{HttpException}} or its documentation must be contrary to the latter.



--
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