| 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.
|
| 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
|
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();
}
}
Copyright © 1999–2013 The Apache Software Foundation. All rights reserved.