Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
  * Copyright 2010-2015, Inc. or its affiliates. All Rights Reserved.
  * Licensed under the Apache License, Version 2.0 (the "License").
  * You may not use this file except in compliance with the License.
  * A copy of the License is located at
 * or in the "license" file accompanying this file. This file is distributed
 * express or implied. See the License for the specific language governing
 * permissions and limitations under the License.
package com.amazonaws.http;

Responsible for handling an HTTP response and returning an object of type T. For example, a typical response handler might accept a response, and translate it into a concrete typed object.

<T> The output of this response handler.
public interface HttpResponseHandler<T> {
    public static final String X_AMZN_REQUEST_ID_HEADER = "x-amzn-RequestId";
Accepts an HTTP response object, and returns an object of type T. Individual implementations may choose to handle the response however they need to, and return any type that they need to.

response The HTTP response to handle, as received from an AWS service.
An object of type T, as defined by individual implementations.
java.lang.Exception If any problems are encountered handling the response.
    public T handle(HttpResponse responsethrows Exception;

Indicates if this response handler requires that the underlying HTTP connection not be closed automatically after the response is handled.

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(com.amazonaws.http.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.

True if this response handler requires that the underlying HTTP connection be left open, and not automatically closed, otherwise false.
    public boolean needsConnectionLeftOpen();
New to GrepCode? Check out our FAQ X