|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectorg.apache.http.impl.client.DecompressingHttpClient
public class DecompressingHttpClient
Decorator adding support for compressed responses. This class sets
the Accept-Encoding header on requests to indicate
support for the gzip and deflate
compression schemes; it then checks the Content-Encoding
header on the response to uncompress any compressed response bodies.
The InputStream of the entity will contain the uncompressed
content.
N.B. Any upstream clients of this class need to be aware that
this effectively obscures visibility into the length of a server
response body, since the Content-Length header will
correspond to the compressed entity length received from the server,
but the content length experienced by reading the response body may
be different (hopefully higher!).
That said, this decorator is compatible with the
CachingHttpClient in that the two decorators can be added
in either order and still have cacheable responses be cached.
| Constructor Summary | |
|---|---|
DecompressingHttpClient(HttpClient backend)
Constructs a decorator to ask for and handle compressed entities on the fly. |
|
| Method Summary | ||
|---|---|---|
HttpResponse |
execute(HttpHost target,
HttpRequest request)
Executes a request to the target using the default context. |
|
HttpResponse |
execute(HttpHost target,
HttpRequest request,
HttpContext context)
Executes a request to the target using the given context. |
|
|
execute(HttpHost target,
HttpRequest request,
ResponseHandler<? extends T> responseHandler)
Executes a request to the target using the default context and processes the response using the given response handler. |
|
|
execute(HttpHost target,
HttpRequest request,
ResponseHandler<? extends T> responseHandler,
HttpContext context)
Executes a request to the target using the given context and processes the response using the given response handler. |
|
HttpResponse |
execute(HttpUriRequest request)
Executes a request using the default context. |
|
HttpResponse |
execute(HttpUriRequest request,
HttpContext context)
Executes a request using the given context. |
|
|
execute(HttpUriRequest request,
ResponseHandler<? extends T> responseHandler)
Executes a request using the default context and processes the response using the given response handler. |
|
|
execute(HttpUriRequest request,
ResponseHandler<? extends T> responseHandler,
HttpContext context)
Executes a request using the given context and processes the response using the given response handler. |
|
ClientConnectionManager |
getConnectionManager()
Obtains the connection manager used by this client. |
|
HttpParams |
getParams()
Obtains the parameters for this client. |
|
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
|---|
public DecompressingHttpClient(HttpClient backend)
backend - the HttpClient to use for actually
issuing requests| Method Detail |
|---|
public HttpParams getParams()
HttpClient
getParams in interface HttpClientpublic ClientConnectionManager getConnectionManager()
HttpClient
getConnectionManager in interface HttpClient
public HttpResponse execute(HttpUriRequest request)
throws IOException,
ClientProtocolException
HttpClient
execute in interface HttpClientrequest - the request to execute
IOException - in case of a problem or the connection was aborted
ClientProtocolException - in case of an http protocol error
public HttpResponse execute(HttpUriRequest request,
HttpContext context)
throws IOException,
ClientProtocolException
HttpClient
execute in interface HttpClientrequest - the request to executecontext - the context to use for the execution, or
null to use the default context
IOException - in case of a problem or the connection was aborted
ClientProtocolException - in case of an http protocol error
public HttpResponse execute(HttpHost target,
HttpRequest request)
throws IOException,
ClientProtocolException
HttpClient
execute in interface HttpClienttarget - the target host for the request.
Implementations may accept null
if they can still determine a route, for example
to a default target or by inspecting the request.request - the request to execute
IOException - in case of a problem or the connection was aborted
ClientProtocolException - in case of an http protocol error
public HttpResponse execute(HttpHost target,
HttpRequest request,
HttpContext context)
throws IOException,
ClientProtocolException
HttpClient
execute in interface HttpClienttarget - the target host for the request.
Implementations may accept null
if they can still determine a route, for example
to a default target or by inspecting the request.request - the request to executecontext - the context to use for the execution, or
null to use the default context
IOException - in case of a problem or the connection was aborted
ClientProtocolException - in case of an http protocol error
public <T> T execute(HttpUriRequest request,
ResponseHandler<? extends T> responseHandler)
throws IOException,
ClientProtocolException
HttpClient
execute in interface HttpClientrequest - the request to executeresponseHandler - the response handler
IOException - in case of a problem or the connection was aborted
ClientProtocolException - in case of an http protocol error
public <T> T execute(HttpUriRequest request,
ResponseHandler<? extends T> responseHandler,
HttpContext context)
throws IOException,
ClientProtocolException
HttpClient
execute in interface HttpClientrequest - the request to executeresponseHandler - the response handler
IOException - in case of a problem or the connection was aborted
ClientProtocolException - in case of an http protocol error
public <T> T execute(HttpHost target,
HttpRequest request,
ResponseHandler<? extends T> responseHandler)
throws IOException,
ClientProtocolException
HttpClient
execute in interface HttpClienttarget - the target host for the request.
Implementations may accept null
if they can still determine a route, for example
to a default target or by inspecting the request.request - the request to executeresponseHandler - the response handler
IOException - in case of a problem or the connection was aborted
ClientProtocolException - in case of an http protocol error
public <T> T execute(HttpHost target,
HttpRequest request,
ResponseHandler<? extends T> responseHandler,
HttpContext context)
throws IOException,
ClientProtocolException
HttpClient
execute in interface HttpClienttarget - the target host for the request.
Implementations may accept null
if they can still determine a route, for example
to a default target or by inspecting the request.request - the request to executeresponseHandler - the response handlercontext - the context to use for the execution, or
null to use the default context
IOException - in case of a problem or the connection was aborted
ClientProtocolException - in case of an http protocol error
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||