T
- Unmarshalled result typepublic class AwsResponseHandlerAdapter<T> extends Object implements HttpResponseHandler<T>
< AmazonWebServiceResponse >
to an HttpResponseHandler
(unwrapped result) with proper handling and logging of response
metadata.X_AMZ_REQUEST_ID_ALTERNATIVE_HEADER, X_AMZN_EXTENDED_REQUEST_ID_HEADER, X_AMZN_REQUEST_ID_HEADER
Constructor and Description |
---|
AwsResponseHandlerAdapter(HttpResponseHandler<AmazonWebServiceResponse<T>> delegate,
Request<?> request,
AWSRequestMetrics awsRequestMetrics,
MetadataCache responseMetadataCache) |
Modifier and Type | Method and Description |
---|---|
T |
handle(HttpResponse response)
Accepts an HTTP response object, and returns an object of type T.
|
boolean |
needsConnectionLeftOpen()
Indicates if this response handler requires that the underlying HTTP
connection not be closed automatically after the response is
handled.
|
public AwsResponseHandlerAdapter(HttpResponseHandler<AmazonWebServiceResponse<T>> delegate, Request<?> request, AWSRequestMetrics awsRequestMetrics, MetadataCache responseMetadataCache)
delegate
- Response handler to delegate to and unwraprequest
- Marshalled requestawsRequestMetrics
- Request metricspublic T handle(HttpResponse response) throws Exception
HttpResponseHandler
handle
in interface HttpResponseHandler<T>
response
- The HTTP response to handle, as received from an AWS service.Exception
- If any problems are encountered handling the response.public boolean needsConnectionLeftOpen()
HttpResponseHandler
For example, if the object returned by this response handler manually
manages the stream of data from the HTTP connection, and doesn't read all
the data from the connection in the HttpResponseHandler.handle(HttpResponse)
method,
this method can be used to prevent the underlying connection from being
prematurely closed.
Response handlers should use this option very carefully, since it means that resource cleanup is no longer handled automatically, and if neglected, can result in the client runtime running out of resources for new HTTP connections.
needsConnectionLeftOpen
in interface HttpResponseHandler<T>
Copyright © 2020. All rights reserved.