You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@hc.apache.org by "Michael Osipov (JIRA)" <ji...@apache.org> on 2015/01/24 17:52:34 UTC
[jira] [Created] (HTTPCLIENT-1603) ClientProtocolException
contradicts tutorial statement
Michael Osipov created HTTPCLIENT-1603:
------------------------------------------
Summary: ClientProtocolException contradicts tutorial statement
Key: HTTPCLIENT-1603
URL: https://issues.apache.org/jira/browse/HTTPCLIENT-1603
Project: HttpComponents HttpClient
Issue Type: Bug
Components: Documentation, HttpClient
Affects Versions: 4.4 Beta1, 4.3.6
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: dev-unsubscribe@hc.apache.org
For additional commands, e-mail: dev-help@hc.apache.org