[
https://issues.apache.org/jira/browse/HTTPCLIENT-1603?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Michael Osipov updated HTTPCLIENT-1603:
---------------------------------------
Description:
[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.
was:
[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.
> 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
>
> [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: [email protected]
For additional commands, e-mail: [email protected]
