com.amazonaws.http

Class AmazonHttpClient

java.lang.Object

com.amazonaws.http.AmazonHttpClient

public class AmazonHttpClient
extends java.lang.Object

The Amazon HTTP Client class.

Constructor Summary

Constructors

Constructor and Description
AmazonHttpClient(ClientConfiguration config) Constructs a new AWS client using the specified client configuration options (ex: max retry attempts, proxy settings, etc).
AmazonHttpClient(ClientConfiguration config, HttpClient httpClient) Constructs a new AWS client using the specified client configuration options (ex: max retry attempts, proxy settings, etc), and request metric collector.
AmazonHttpClient(ClientConfiguration config, HttpClient httpClient, RequestMetricCollector requestMetricCollector) Deprecated.
AmazonHttpClient(ClientConfiguration config, RequestMetricCollector requestMetricCollector) Deprecated.

Method Summary

Modifier and Type	Method and Description
<T> Response<T>	execute(Request<?> request, HttpResponseHandler<AmazonWebServiceResponse<T>> responseHandler, HttpResponseHandler<AmazonServiceException> errorResponseHandler, ExecutionContext executionContext) Executes the request and returns the result.
protected void	finalize()
RequestMetricCollector	getRequestMetricCollector()
ResponseMetadata	getResponseMetadataForRequest(AmazonWebServiceRequest request) Deprecated. ResponseMetadata cache can hold up to 50 requests and responses in memory and will cause memory issue. This method now always returns null.
void	shutdown() Shuts down this HTTP client object, releasing any resources that might be held open.

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AmazonHttpClient

public AmazonHttpClient(ClientConfiguration config)

Constructs a new AWS client using the specified client configuration options (ex: max retry attempts, proxy settings, etc).

Parameters:

config - Configuration options specifying how this client will communicate with AWS (ex: proxy settings, retry count, etc.).

AmazonHttpClient

@Deprecated
public AmazonHttpClient(ClientConfiguration config,
                                    RequestMetricCollector requestMetricCollector)

Deprecated.

Constructs a new AWS client using the specified client configuration options (ex: max retry attempts, proxy settings, etc), and request metric collector.

Parameters:

config - Configuration options specifying how this client will communicate with AWS (ex: proxy settings, retry count, etc.).

requestMetricCollector - client specific request metric collector, which takes precedence over the one at the AWS SDK level; or null if there is none.

AmazonHttpClient

public AmazonHttpClient(ClientConfiguration config,
                        HttpClient httpClient)

Constructs a new AWS client using the specified client configuration options (ex: max retry attempts, proxy settings, etc), and request metric collector.

Parameters:

config - Configuration options specifying how this client will communicate with AWS (ex: proxy settings, retry count, etc.).

httpClient - client specific HttpClient

AmazonHttpClient

@Deprecated
public AmazonHttpClient(ClientConfiguration config,
                                    HttpClient httpClient,
                                    RequestMetricCollector requestMetricCollector)

Deprecated.

Constructs a new AWS client using the specified client configuration options (ex: max retry attempts, proxy settings, etc), and request metric collector.

Parameters:

config - Configuration options specifying how this client will communicate with AWS (ex: proxy settings, retry count, etc.).

httpClient - client specific HttpClient

requestMetricCollector - client specific request metric collector, which takes precedence over the one at the AWS SDK level; or null if there is none.

Method Detail

getResponseMetadataForRequest

@Deprecated
public ResponseMetadata getResponseMetadataForRequest(AmazonWebServiceRequest request)

Deprecated. ResponseMetadata cache can hold up to 50 requests and responses in memory and will cause memory issue. This method now always returns null.

Returns additional response metadata for an executed request. Response metadata isn't considered part of the standard results returned by an operation, so it's accessed instead through this diagnostic interface. Response metadata is typically used for troubleshooting issues with AWS support staff when services aren't acting as expected.

Parameters:

request - A previously executed AmazonWebServiceRequest object, whose response metadata is desired.

Returns:

The response metadata for the specified request, otherwise null if there is no response metadata available for the request.

execute

public <T> Response<T> execute(Request<?> request,
                               HttpResponseHandler<AmazonWebServiceResponse<T>> responseHandler,
                               HttpResponseHandler<AmazonServiceException> errorResponseHandler,
                               ExecutionContext executionContext)

Executes the request and returns the result.

Type Parameters:

T - the response type.

Parameters:

request - The AmazonWebServices request to send to the remote server

responseHandler - A response handler to accept a successful response from the remote server

errorResponseHandler - A response handler to accept an unsuccessful response from the remote server

executionContext - Additional information about the context of this web service call

Returns:

the result of the request.

shutdown

public void shutdown()

Shuts down this HTTP client object, releasing any resources that might be held open. This is an optional method, and callers are not expected to call it, but can if they want to explicitly release any open resources. Once a client has been shutdown, it cannot be used to make more requests.

finalize

protected void finalize()
                 throws java.lang.Throwable

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable

getRequestMetricCollector

public RequestMetricCollector getRequestMetricCollector()

Returns:

the http client specific request metric collector; or null if there is none.