Package org.apache.http.client

The API for client-side HTTP communication.

See: Description

Interface Summary

Interface	Description
AuthCache	Abstract AuthScheme cache.
AuthenticationHandler	Deprecated (4.2) use AuthenticationStrategy
AuthenticationStrategy	/** A handler for determining if an HTTP response represents an authentication challenge that was sent back to the client as a result of authentication failure.
BackoffManager	Represents a controller that dynamically adjusts the size of an available connection pool based on feedback from using the connections.
ConnectionBackoffStrategy	When managing a dynamic number of connections for a given route, this strategy assesses whether a given request execution outcome should result in a backoff signal or not, based on either examining the Throwable that resulted or by examining the resulting response (e.g.
CookieStore	This interface represents an abstract store for Cookie objects.
CredentialsProvider	Abstract credentials provider that maintains a collection of user credentials.
HttpClient	This interface represents only the most basic contract for HTTP request execution.
HttpRequestRetryHandler	A handler for determining if an HttpRequest should be retried after a recoverable exception during execution.
RedirectHandler	Deprecated (4.1) use RedirectStrategy
RedirectStrategy	A strategy for determining if an HTTP request should be redirected to a new location in response to an HTTP response received from the target server.
RequestDirector	A client-side request director.
ResponseHandler<T>	Handler that encapsulates the process of generating a response object from a HttpResponse.
ServiceUnavailableRetryStrategy	Strategy interface that allows API users to plug in their own logic to control whether or not a retry should automatically be done, how many times it should be retried and so on.
UserTokenHandler	A handler for determining if the given execution context is user specific or not.

Class Summary

Class	Description
URICollection	This class represents an iterable collection of URIs.

Exception Summary

Exception	Description
CircularRedirectException	Signals a circular redirect
ClientProtocolException	Signals an error in the HTTP protocol.
HttpResponseException	Signals a non 2xx HTTP response.
NonRepeatableRequestException	Signals failure to retry the request due to non-repeatable request entity.
RedirectException	Signals violation of HTTP specification caused by an invalid redirect

Package org.apache.http.client Description

The API for client-side HTTP communication.

The usual execution flow can be demonstrated by the code snippet below:

HttpClient httpclient = new DefaultHttpClient();

// Prepare a request object
HttpGet httpget = new HttpGet("http://www.apache.org/");

// Execute the request
HttpResponse response = httpclient.execute(httpget);

// Examine the response status
System.out.println(response.getStatusLine());

// Get hold of the response entity
HttpEntity entity = response.getEntity();

// If the response does not enclose an entity, there is no need
// to worry about connection release
if (entity != null) {
    InputStream instream = entity.getContent();
    try {

        BufferedReader reader = new BufferedReader(
                new InputStreamReader(instream));
        // do something useful with the response
        System.out.println(reader.readLine());

    } catch (IOException ex) {

        // In case of an IOException the connection will be released
        // back to the connection manager automatically
        throw ex;

    } catch (RuntimeException ex) {

        // In case of an unexpected exception you may want to abort
        // the HTTP request in order to shut down the underlying
        // connection and release it back to the connection manager.
        httpget.abort();
        throw ex;

    } finally {

        // Closing the input stream will trigger connection release
        instream.close();

    }
}