com.google.cloud

Class BaseServiceException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.google.cloud.BaseServiceException

All Implemented Interfaces:

Serializable

public class BaseServiceException
extends RuntimeException

Base class for all service exceptions.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	BaseServiceException.Error

Field Summary

Fields

Modifier and Type	Field and Description
static int	UNKNOWN_CODE

Constructor Summary

Constructors

Constructor and Description
BaseServiceException(com.google.api.client.googleapis.json.GoogleJsonError googleJsonError, boolean idempotent)
BaseServiceException(int code, String message, String reason, boolean idempotent)
BaseServiceException(int code, String message, String reason, boolean idempotent, Throwable cause)
BaseServiceException(IOException exception, boolean idempotent)

Method Summary

Methods

Modifier and Type	Method and Description
int	code() Returns the code associated with this exception.
protected String	debugInfo()
boolean	equals(Object obj)
int	hashCode()
boolean	idempotent() Returns true when the operation that caused this exception had no side effects.
protected boolean	isRetryable(boolean idempotent, BaseServiceException.Error error)
protected boolean	isRetryable(boolean idempotent, IOException exception)
String	location() Returns the service location where the error causing the exception occurred.
String	reason() Returns the reason that caused the exception.
boolean	retryable() Returns true when it is safe to retry the operation that caused this exception.
protected Set<BaseServiceException.Error>	retryableErrors()
protected static void	translateAndPropagateIfPossible(RetryHelper.RetryHelperException ex)

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, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

UNKNOWN_CODE

public static final int UNKNOWN_CODE

See Also:

Constant Field Values

Constructor Detail

BaseServiceException

public BaseServiceException(IOException exception,
                    boolean idempotent)

BaseServiceException

public BaseServiceException(com.google.api.client.googleapis.json.GoogleJsonError googleJsonError,
                    boolean idempotent)

BaseServiceException

public BaseServiceException(int code,
                    String message,
                    String reason,
                    boolean idempotent)

BaseServiceException

public BaseServiceException(int code,
                    String message,
                    String reason,
                    boolean idempotent,
                    Throwable cause)

Method Detail

retryableErrors

protected Set<BaseServiceException.Error> retryableErrors()

isRetryable

protected boolean isRetryable(boolean idempotent,
                  BaseServiceException.Error error)

isRetryable

protected boolean isRetryable(boolean idempotent,
                  IOException exception)

code

public int code()

Returns the code associated with this exception.

reason

public String reason()

Returns the reason that caused the exception.

retryable

public boolean retryable()

Returns true when it is safe to retry the operation that caused this exception.

idempotent

public boolean idempotent()

Returns true when the operation that caused this exception had no side effects.

location

public String location()

Returns the service location where the error causing the exception occurred. Returns null if not available.

debugInfo

protected String debugInfo()

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

translateAndPropagateIfPossible

protected static void translateAndPropagateIfPossible(RetryHelper.RetryHelperException ex)