com.google.cloud.spanner

Class SpannerExceptionFactory

java.lang.Object

com.google.cloud.spanner.SpannerExceptionFactory

public final class SpannerExceptionFactory
extends Object

A factory for creating instances of SpannerException and its subtypes. All creation of these exceptions is directed through the factory. This ensures that particular types of errors are always expressed as the same concrete exception type. For example, exceptions of type ErrorCode.ABORTED are always represented by AbortedException.

Constructor Summary

Constructors

Constructor and Description
SpannerExceptionFactory()

Method Summary

Modifier and Type	Method and Description
static SpannerBatchUpdateException	newSpannerBatchUpdateException(ErrorCode code, String message, long[] updateCounts)
static SpannerException	newSpannerException(Context context, Throwable cause) Creates a new exception based on cause.
static SpannerException	newSpannerException(ErrorCode code, String message)
static SpannerException	newSpannerException(ErrorCode code, String message, Throwable cause)
static SpannerException	newSpannerException(Throwable cause) Creates a new exception based on cause.
static SpannerException	propagateInterrupt(InterruptedException e)
static SpannerException	propagateTimeout(TimeoutException e) Transforms a TimeoutException to a SpannerException.

Methods inherited from class java.lang.Object

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

Constructor Detail

SpannerExceptionFactory

public SpannerExceptionFactory()

Method Detail

newSpannerException

public static SpannerException newSpannerException(ErrorCode code,
                                                   @Nullable
                                                   String message)

newSpannerException

public static SpannerException newSpannerException(ErrorCode code,
                                                   @Nullable
                                                   String message,
                                                   @Nullable
                                                   Throwable cause)

propagateInterrupt

public static SpannerException propagateInterrupt(InterruptedException e)

propagateTimeout

public static SpannerException propagateTimeout(TimeoutException e)

Transforms a TimeoutException to a SpannerException.

 
 try {
   Spanner spanner = SpannerOptions.getDefaultInstance();
   spanner
       .getDatabaseAdminClient()
       .createDatabase("[INSTANCE_ID]", "[DATABASE_ID]", [STATEMENTS])
       .get();
 } catch (TimeoutException e) {
   propagateTimeout(e);
 }
 
 

newSpannerException

public static SpannerException newSpannerException(Throwable cause)

Creates a new exception based on cause.

Intended for internal library use; user code should use newSpannerException(ErrorCode, String) instead of this method.

newSpannerBatchUpdateException

public static SpannerBatchUpdateException newSpannerBatchUpdateException(ErrorCode code,
                                                                         String message,
                                                                         long[] updateCounts)

newSpannerException

public static SpannerException newSpannerException(@Nullable
                                                   Context context,
                                                   Throwable cause)

Creates a new exception based on cause. If cause indicates cancellation, context will be inspected to establish the type of cancellation.

Intended for internal library use; user code should use newSpannerException(ErrorCode, String) instead of this method.