com.amazonaws.services.s3.internal

Class S3ErrorResponseHandler

java.lang.Object

com.amazonaws.services.s3.internal.S3ErrorResponseHandler

All Implemented Interfaces:

HttpResponseHandler<AmazonServiceException>

public class S3ErrorResponseHandler
extends Object
implements HttpResponseHandler<AmazonServiceException>

Response handler for S3 error responses. S3 error responses are different from other AWS error responses in a few ways. Most error responses will contain an XML body, but not all (ex: error responses to HEAD requests will not), so this error handler has to account for that. The actual XML error response body is slightly different than other services like SimpleDB or EC2 and some information isn't explicitly represented in the XML error response body (ex: error type/fault information) so it has to be inferred from other parts of the error response.

Field Summary

Fields inherited from interface com.amazonaws.http.HttpResponseHandler

X_AMZ_REQUEST_ID_ALTERNATIVE_HEADER, X_AMZN_EXTENDED_REQUEST_ID_HEADER, X_AMZN_REQUEST_ID_HEADER

Constructor Summary

Constructors

Constructor and Description
S3ErrorResponseHandler(ClientConfiguration clientConfiguration)

Method Summary

Modifier and Type	Method and Description
AmazonServiceException	handle(HttpResponse httpResponse)
boolean	needsConnectionLeftOpen() Since this response handler completely consumes all the data from the underlying HTTP connection during the handle method, we don't need to keep the HTTP connection open.

Methods inherited from class java.lang.Object

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

Constructor Detail

S3ErrorResponseHandler

public S3ErrorResponseHandler(ClientConfiguration clientConfiguration)

Method Detail

handle

public AmazonServiceException handle(HttpResponse httpResponse)
                              throws XMLStreamException

Specified by:

handle in interface HttpResponseHandler<AmazonServiceException>

Throws:

XMLStreamException

needsConnectionLeftOpen

public boolean needsConnectionLeftOpen()

Since this response handler completely consumes all the data from the underlying HTTP connection during the handle method, we don't need to keep the HTTP connection open.

Specified by:

needsConnectionLeftOpen in interface HttpResponseHandler<AmazonServiceException>

See Also:

HttpResponseHandler.needsConnectionLeftOpen()