com.microsoft.azure.storage.StorageException Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of azure-storage Show documentation
Show all versions of azure-storage Show documentation
SDK for Microsoft Azure Storage Clients
/**
* Copyright Microsoft Corporation
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.microsoft.azure.storage;
import java.io.IOException;
import java.net.HttpURLConnection;
import java.net.SocketException;
import com.microsoft.azure.storage.core.StorageRequest;
import com.microsoft.azure.storage.core.Utility;
/**
* Represents an exception for the Microsoft Azure storage service.
*/
public class StorageException extends Exception {
/**
* Represents the serialization version number.
*/
private static final long serialVersionUID = 7972747254288274928L;
/**
* RESERVED FOR INTERNAL USE. Translates the specified exception into a storage exception.
*
* @param cause
* An Exception
object that represents the exception to translate.
*
* @return A StorageException
object that represents translated exception.
*/
public static StorageException translateClientException(final Exception cause) {
return new StorageException("Client error",
"A Client side exception occurred, please check the inner exception for details",
Constants.HeaderConstants.HTTP_UNUSED_306, null, cause);
}
/**
* RESERVED FOR INTERNAL USE. Translates the specified exception into a storage exception.
*
* @param request
* An HttpURLConnection
object that represents the request whose exception is being
* translated.
* @param cause
* An Exception
object that represents the exception to translate.
*
* @return A StorageException
object that represents translated exception.
*/
public static StorageException translateException(final StorageRequest request, final Exception cause,
final OperationContext opContext) {
if (request == null || request.getConnection() == null) {
return translateClientException(cause);
}
if (cause instanceof SocketException) {
String message = cause == null ? Constants.EMPTY_STRING : cause.getMessage();
return new StorageException(StorageErrorCode.SERVICE_INTERNAL_ERROR.toString(),
"An unknown failure occurred : ".concat(message), HttpURLConnection.HTTP_INTERNAL_ERROR,
null, cause);
}
StorageException translatedException = null;
String responseMessage = null;
int responseCode = 0;
try {
responseCode = request.getConnection().getResponseCode();
responseMessage = request.getConnection().getResponseMessage();
} catch (final IOException e) {
// ignore errors
}
if (responseMessage == null) {
responseMessage = Constants.EMPTY_STRING;
}
StorageExtendedErrorInformation extendedError = request.parseErrorDetails();
translatedException = new StorageException(request.getResult().getErrorCode(), responseMessage,
responseCode, extendedError, cause);
Utility.logHttpError(translatedException, opContext);
return translatedException;
}
/**
* Represents the error code returned by the operation.
*/
protected String errorCode;
/**
* Represents the extended error information returned by the operation.
*
* @see StorageExtendedErrorInformation
*/
protected StorageExtendedErrorInformation extendedErrorInformation;
/**
* Represents the HTTP status code returned by the operation.
*/
private final int httpStatusCode;
/**
* 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.
*
* @param errorCode
* A String
that represents the error code returned by the operation.
* @param message
* A String
that represents the error message returned by the operation.
* @param innerException
* An Exception
object that represents a reference to the initial exception, if one exists.
*
* @see StorageExtendedErrorInformation
*/
public StorageException(final String errorCode, final String message, final Exception innerException) {
this(errorCode, message, Constants.HeaderConstants.HTTP_UNUSED_306, null, innerException);
}
/**
* Creates an instance of the StorageException
class using the specified parameters.
*
* @param errorCode
* A String
that represents the error code returned by the operation.
* @param message
* A String
that represents the error message returned by the operation.
* @param statusCode
* The HTTP status code returned by the operation.
* @param extendedErrorInfo
* A {@link StorageExtendedErrorInformation} object that represents the extended error information
* returned by the operation.
* @param innerException
* An Exception
object that represents a reference to the initial exception, if one exists.
*
* @see StorageExtendedErrorInformation
*/
public StorageException(final String errorCode, final String message, final int statusCode,
final StorageExtendedErrorInformation extendedErrorInfo, final Exception innerException) {
super(message, innerException);
this.errorCode = errorCode;
this.httpStatusCode = statusCode;
this.extendedErrorInformation = extendedErrorInfo;
}
/**
* Gets the error code returned by the operation.
*
* @return the errorCode
*/
public String getErrorCode() {
return this.errorCode;
}
/**
* Gets the extended error information returned by the operation.
*
* @return the extendedErrorInformation
*/
public StorageExtendedErrorInformation getExtendedErrorInformation() {
return this.extendedErrorInformation;
}
/**
* Gets the HTTP status code returned by the operation.
*
* @return the httpStatusCode
*/
public int getHttpStatusCode() {
return this.httpStatusCode;
}
}