com.google.api.gax.rpc

Class ApiException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.google.api.gax.rpc.ApiException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

AbortedException, AlreadyExistsException, CancelledException, DataLossException, DeadlineExceededException, FailedPreconditionException, InternalException, InvalidArgumentException, NotFoundException, OutOfRangeException, PermissionDeniedException, ResourceExhaustedException, UnauthenticatedException, UnavailableException, UnimplementedException, UnknownException, WatchdogTimeoutException

public class ApiException
extends RuntimeException

Represents an exception thrown during an RPC call.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ApiException(String message, Throwable cause, StatusCode statusCode, boolean retryable)
ApiException(Throwable cause, StatusCode statusCode, boolean retryable)
ApiException(Throwable cause, StatusCode statusCode, boolean retryable, ErrorDetails errorDetails)

Method Summary

Modifier and Type	Method and Description
String	getDomain() Returns the logical grouping to which the "reason" belongs.
ErrorDetails	getErrorDetails() Returns all standard error messages that server sends.
Map<String,String>	getMetadata() Returns additional structured details about this exception.
String	getReason() Returns the reason of the exception.
StatusCode	getStatusCode() Returns the status code of the underlying exception.
boolean	isRetryable() Returns whether the failed request can be retried.

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

Constructor Detail

ApiException

public ApiException(Throwable cause,
                    StatusCode statusCode,
                    boolean retryable)

ApiException

public ApiException(String message,
                    Throwable cause,
                    StatusCode statusCode,
                    boolean retryable)

ApiException

public ApiException(Throwable cause,
                    StatusCode statusCode,
                    boolean retryable,
                    ErrorDetails errorDetails)

Method Detail

isRetryable

public boolean isRetryable()

Returns whether the failed request can be retried.

getStatusCode

public StatusCode getStatusCode()

Returns the status code of the underlying exception.

getReason

public String getReason()

Returns the reason of the exception. This is a constant value that identifies the proximate cause of the error. e.g. SERVICE_DISABLED

getDomain

public String getDomain()

Returns the logical grouping to which the "reason" belongs. The error domain is typically the registered service name of the tool or product that generates the error. e.g. googleapis.com

getMetadata

public Map<String,String> getMetadata()

Returns additional structured details about this exception.

getErrorDetails

public ErrorDetails getErrorDetails()

Returns all standard error messages that server sends.