com.amazonaws.services.s3.model
Class AmazonS3Exception

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by com.amazonaws.AmazonClientException
                  extended by com.amazonaws.AmazonServiceException
                      extended by com.amazonaws.services.s3.model.AmazonS3Exception
All Implemented Interfaces:
Serializable
Direct Known Subclasses:
MultiObjectDeleteException

public class AmazonS3Exception
extends AmazonServiceException

Provides an extension of the AmazonServiceException for errors reported by Amazon S3 while processing a request. In particular, this class provides access to Amazon S3's extended request ID. This ID is required debugging information in the case the user needs to contact Amazon about an issue where Amazon S3 is incorrectly handling a request.

See Also:
Serialized Form

Nested Class Summary
 
Nested classes/interfaces inherited from class com.amazonaws.AmazonServiceException
AmazonServiceException.ErrorType
 
Constructor Summary
AmazonS3Exception(String message)
          Constructs a new AmazonS3Exception with the specified message.
AmazonS3Exception(String message, Exception cause)
          Constructs a new AmazonS3Exception with the specified message and root cause.
 
Method Summary
 String getExtendedRequestId()
          Gets Amazon S3's extended request ID.
 void setExtendedRequestId(String extendedRequestId)
          Sets Amazon S3's extended request ID.
 String toString()
          Extends the implementation from AmazonServiceException to include additional information on S3's extended request ID.
 
Methods inherited from class com.amazonaws.AmazonServiceException
getErrorCode, getErrorType, getRequestId, getServiceName, getStatusCode, setErrorCode, setErrorType, setRequestId, setServiceName, setStatusCode
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

AmazonS3Exception

public AmazonS3Exception(String message)
Constructs a new AmazonS3Exception with the specified message.

Parameters:
message - The error message describing why this exception was thrown.
See Also:
AmazonS3Exception(String, Exception)

AmazonS3Exception

public AmazonS3Exception(String message,
                         Exception cause)
Constructs a new AmazonS3Exception with the specified message and root cause.

Parameters:
message - The error message describing why this exception was thrown.
cause - The root exception that caused this exception to be thrown.
See Also:
AmazonS3Exception(String)
Method Detail

getExtendedRequestId

public String getExtendedRequestId()
Gets Amazon S3's extended request ID. This ID is required debugging information in the case the user needs to contact Amazon about an issue where Amazon S3 is incorrectly handling a request.

Returns:
Amazon S3's extended request ID.
See Also:
setExtendedRequestId(String)

setExtendedRequestId

public void setExtendedRequestId(String extendedRequestId)
Sets Amazon S3's extended request ID.

Parameters:
extendedRequestId - S3's extended request ID.
See Also:
getExtendedRequestId()

toString

public String toString()
Extends the implementation from AmazonServiceException to include additional information on S3's extended request ID.

Overrides:
toString in class AmazonServiceException
See Also:
Throwable.toString()


Copyright © 2010 Amazon Web Services, Inc. All Rights Reserved.