hc-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Michael Osipov (JIRA)" <j...@apache.org>
Subject [jira] [Created] (HTTPCLIENT-1603) ClientProtocolException contradicts tutorial statement
Date Sat, 24 Jan 2015 16:52:34 GMT
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

To unsubscribe, e-mail: dev-unsubscribe@hc.apache.org
For additional commands, e-mail: dev-help@hc.apache.org

View raw message