com.amazonaws.http

Interface HttpClient

All Known Implementing Classes:

ApacheHttpClient, UrlHttpClient

public interface HttpClient

Interface for an HTTP client. Its main responsibility is to execute an HttpRequest and return a HttpResponse. There are some requirements for its implementation.

• Execute the request without any modification. An HttpRequest is converted from an AmazonWebServiceRequest with signature information. If modified, the request is likely to be rejected by AWS service.
• Disable retry logic and redirect which are handled by the service client itself.
• Enable BrowserCompatHostnameVerifier so that a wildcard (such as "*.amazonaws.com") matches all subdomains, including "a.b.amazonaws.com". This is needed for S3 virtual hosting. See Virtual Hosting of Buckets for more details.
• Beware of the Expect 100-continue header. Currently it's only used in S3's Put Object API. S3 can fail the request with a status code other than 100 (continue) or 417 (reject) an an error message in the body.
• Cache is unnecessary and isn't recommended to implement until it's supported by AWS service.

Method Summary

Modifier and Type	Method and Description
HttpResponse	execute(HttpRequest request) Executes a HttpRequest and returns a HttpResponse.
void	shutdown() Forcefully shutdown this HTTP client and release all underlying resources.

Method Detail

execute

HttpResponse execute(HttpRequest request)
              throws IOException

Executes a HttpRequest and returns a HttpResponse.

Parameters:

request - a HTTP request

Returns:

the response object

Throws:

IOException - in case of a connection problem

shutdown

void shutdown()

Forcefully shutdown this HTTP client and release all underlying resources.