T
- The output of this response handler.@FunctionalInterface public interface HttpResponseHandler<T>
Modifier and Type | Field and Description |
---|---|
static String |
X_AMZ_ID_2_HEADER |
static String |
X_AMZN_REQUEST_ID_HEADER |
Modifier and Type | Method and Description |
---|---|
T |
handle(SdkHttpFullResponse response,
ExecutionAttributes executionAttributes)
Accepts an HTTP response object, and returns an object of type T.
|
default boolean |
needsConnectionLeftOpen()
Indicates if this response handler requires that the underlying HTTP
connection not be closed automatically after the response is
handled.
|
static final String X_AMZN_REQUEST_ID_HEADER
static final String X_AMZ_ID_2_HEADER
T handle(SdkHttpFullResponse response, ExecutionAttributes executionAttributes) throws Exception
response
- The HTTP response to handle, as received from an AWS service.executionAttributes
- The attributes attached to this particular execution.Exception
- If any problems are encountered handling the response.default boolean needsConnectionLeftOpen()
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 handle(SdkHttpFullResponse, ExecutionAttributes)
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.
Copyright © 2019. All rights reserved.