com.microsoft.azure.storage

Class StorageException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.microsoft.azure.storage.StorageException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

TableServiceException

public class StorageException
extends Exception

Represents an exception for the Microsoft Azure storage service.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected String	errorCode Represents the error code returned by the operation.
protected StorageExtendedErrorInformation	extendedErrorInformation Represents the extended error information returned by the operation.

Constructor Summary

Constructors

Constructor and Description
StorageException(String errorCode, String message, Exception innerException) Creates an instance of the StorageException class using the specified parameters.
StorageException(String errorCode, String message, int statusCode, StorageExtendedErrorInformation extendedErrorInfo, Exception innerException) Creates an instance of the StorageException class using the specified parameters.

Method Summary

Modifier and Type	Method and Description
String	getErrorCode() Gets the error code returned by the operation.
StorageExtendedErrorInformation	getExtendedErrorInformation() Gets the extended error information returned by the operation.
int	getHttpStatusCode() Gets the HTTP status code returned by the operation.
static StorageException	translateClientException(Exception cause) RESERVED FOR INTERNAL USE.
static StorageException	translateException(StorageRequest<?,?,?> request, Exception cause, OperationContext opContext) RESERVED FOR INTERNAL USE.
protected static StorageException	translateFromHttpStatus(int statusCode, String statusDescription, Exception inner) Translates the specified HTTP status code into a storage exception.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Field Detail

errorCode

protected String errorCode

Represents the error code returned by the operation.

extendedErrorInformation

protected StorageExtendedErrorInformation extendedErrorInformation

Represents the extended error information returned by the operation.

See Also:

StorageExtendedErrorInformation

Constructor Detail

StorageException

public StorageException(String errorCode,
                        String message,
                        Exception innerException)

Creates an instance of the StorageException class using the specified parameters. The status code will be 306 to represent a client side exception with null for the extended error information.

Parameters:

errorCode - A String that represents the error code returned by the operation.

message - A String that represents the error message returned by the operation.

innerException - An Exception object that represents a reference to the initial exception, if one exists.

See Also:

StorageExtendedErrorInformation

StorageException

public StorageException(String errorCode,
                        String message,
                        int statusCode,
                        StorageExtendedErrorInformation extendedErrorInfo,
                        Exception innerException)

Creates an instance of the StorageException class using the specified parameters.

Parameters:

errorCode - A String that represents the error code returned by the operation.

message - A String that represents the error message returned by the operation.

statusCode - The HTTP status code returned by the operation.

extendedErrorInfo - A StorageExtendedErrorInformation object that represents the extended error information returned by the operation.

innerException - An Exception object that represents a reference to the initial exception, if one exists.

See Also:

StorageExtendedErrorInformation

Method Detail

translateClientException

public static StorageException translateClientException(Exception cause)

RESERVED FOR INTERNAL USE. Translates the specified exception into a storage exception.

Parameters:

cause - An Exception object that represents the exception to translate.

Returns:

A StorageException object that represents translated exception.

translateException

public static StorageException translateException(StorageRequest<?,?,?> request,
                                                  Exception cause,
                                                  OperationContext opContext)

RESERVED FOR INTERNAL USE. Translates the specified exception into a storage exception.

Parameters:

request - An HttpURLConnection object that represents the request whose exception is being translated.

cause - An Exception object that represents the exception to translate.

Returns:

A StorageException object that represents translated exception.

translateFromHttpStatus

protected static StorageException translateFromHttpStatus(int statusCode,
                                                          String statusDescription,
                                                          Exception inner)

Translates the specified HTTP status code into a storage exception.

Parameters:

statusCode - The HTTP status code returned by the operation.

statusDescription - A String that represents the status description.

inner - An Exception object that represents a reference to the initial exception, if one exists.

Returns:

A StorageException object that represents translated exception.

getErrorCode

public String getErrorCode()

Gets the error code returned by the operation.

Returns:

the errorCode

getExtendedErrorInformation

public StorageExtendedErrorInformation getExtendedErrorInformation()

Gets the extended error information returned by the operation.

Returns:

the extendedErrorInformation

getHttpStatusCode

public int getHttpStatusCode()

Gets the HTTP status code returned by the operation.

Returns:

the httpStatusCode