com.amazonaws.http

Interface HttpClient

All Known Implementing Classes:

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.
href="http://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html" >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 java.io.IOException

Executes a HttpRequest and returns a HttpResponse.

Parameters:

request - a HTTP request

Returns:

the response object

Throws:

java.io.IOException - in case of a connection problem

shutdown

void shutdown()

Forcefully shutdown this HTTP client and release all underlying resources.