public final class ApacheHttpClientHandler extends Object implements ClientHandler
Client operations are thread safe, the HTTP connection may be shared between different threads.
If a response entity is obtained that is an instance of Closeable
then the instance MUST be closed after processing the entity to release
connection-based resources.
If a ClientResponse
is obtained and an entity is not read from the
response then ClientResponse.close()
MUST be called after processing
the response to release connection-based resources.
The following methods are currently supported: HEAD, GET, POST, PUT, DELETE and OPTIONS.
Chunked transfer encoding can be enabled or disabled but configuration of
the chunked encoding size is not possible. If the
ClientConfig.PROPERTY_CHUNKED_ENCODING_SIZE
property is set
to a non-null value then chunked transfer encoding is enabled.
Constructor and Description |
---|
ApacheHttpClientHandler(org.apache.commons.httpclient.HttpClient client)
Create a new root handler with an
HttpClient . |
ApacheHttpClientHandler(org.apache.commons.httpclient.HttpClient client,
ClientConfig config)
Create a new root handler with an
HttpClient . |
ApacheHttpClientHandler(org.apache.commons.httpclient.HttpClient client,
ClientConfig config,
ApacheHttpMethodExecutor methodExecutor)
Create a new root handler with an
HttpClient . |
Modifier and Type | Method and Description |
---|---|
ClientConfig |
getConfig()
Get the client config.
|
org.apache.commons.httpclient.HttpClient |
getHttpClient()
Get the
HttpClient . |
ClientResponse |
handle(ClientRequest cr)
Handle a HTTP request as a
ClientRequest and return the HTTP
response as a ClientResponse . |
public ApacheHttpClientHandler(org.apache.commons.httpclient.HttpClient client)
HttpClient
.client
- the HttpClient
.public ApacheHttpClientHandler(org.apache.commons.httpclient.HttpClient client, ClientConfig config)
HttpClient
.client
- the HttpClient
.config
- the client configuration.public ApacheHttpClientHandler(org.apache.commons.httpclient.HttpClient client, ClientConfig config, ApacheHttpMethodExecutor methodExecutor)
HttpClient
.client
- the HttpClient
.config
- the client configuration.methodExecutor
- the method executor.public ClientConfig getConfig()
public org.apache.commons.httpclient.HttpClient getHttpClient()
HttpClient
.HttpClient
.public ClientResponse handle(ClientRequest cr) throws ClientHandlerException
ClientHandler
ClientRequest
and return the HTTP
response as a ClientResponse
.handle
in interface ClientHandler
cr
- the HTTP request.ClientHandlerException
- if the client
handler fails to process the request or response.Copyright © 2013 Oracle Corporation. All rights reserved.