com.ibm.cloud.objectstorage.services.s3.internal

Class S3XmlResponseHandler<T>

java.lang.Object

com.ibm.cloud.objectstorage.services.s3.internal.AbstractS3ResponseHandler<T>

com.ibm.cloud.objectstorage.services.s3.internal.S3XmlResponseHandler<T>

All Implemented Interfaces:

HttpResponseHandler<AmazonWebServiceResponse<T>>

Direct Known Subclasses:

ResponseHeaderHandlerChain

public class S3XmlResponseHandler<T>
extends AbstractS3ResponseHandler<T>

S3 Implementation of HttpResponseHandler. Relies on a SAX unmarshaller for handling the response.

Field Summary

Fields inherited from interface com.ibm.cloud.objectstorage.http.HttpResponseHandler

X_AMZ_REQUEST_ID_ALTERNATIVE_HEADER, X_AMZN_EXTENDED_REQUEST_ID_HEADER, X_AMZN_QUERY_ERROR, X_AMZN_REQUEST_ID_HEADER

Constructor Summary

Constructors

Constructor and Description
S3XmlResponseHandler(com.ibm.cloud.objectstorage.transform.Unmarshaller<T,InputStream> responseUnmarshaller) Constructs a new S3 response handler that will use the specified SAX unmarshaller to turn the response into an object.

Method Summary

Modifier and Type	Method and Description
Map<String,String>	getResponseHeaders() Returns the headers from the processed response.
AmazonWebServiceResponse<T>	handle(HttpResponse response) Accepts an HTTP response object, and returns an object of type T.

Methods inherited from class com.ibm.cloud.objectstorage.services.s3.internal.AbstractS3ResponseHandler

needsConnectionLeftOpen, parseResponseMetadata, populateObjectMetadata

Methods inherited from class java.lang.Object

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

Constructor Detail

S3XmlResponseHandler

public S3XmlResponseHandler(com.ibm.cloud.objectstorage.transform.Unmarshaller<T,InputStream> responseUnmarshaller)

Constructs a new S3 response handler that will use the specified SAX unmarshaller to turn the response into an object.

Parameters:

responseUnmarshaller - The SAX unmarshaller to use on the response from S3.

Method Detail

handle

public AmazonWebServiceResponse<T> handle(HttpResponse response)
                                   throws Exception

Description copied from interface: HttpResponseHandler

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.

Parameters:

response - The HTTP response to handle, as received from an AWS service.

Returns:

An object of type T, as defined by individual implementations.

Throws:

Exception - If any problems are encountered handling the response.

See Also:

HttpResponseHandler.handle(com.ibm.cloud.objectstorage.http.HttpResponse)

getResponseHeaders

public Map<String,String> getResponseHeaders()

Returns the headers from the processed response. Will return null until a response has been handled.

Returns:

the headers from the processed response.