com.google.cloud.hadoop.util

Class RetryDeterminer<X extends Exception>

java.lang.Object

com.google.cloud.hadoop.util.RetryDeterminer<X>

Type Parameters:

X - The type of exception you are checking and could possibly return.

public abstract class RetryDeterminer<X extends Exception>
extends Object

This abstract class is designed to tell if an exception is transient and should result in a retry or not, and should result in a returned exception to the caller. Meant to be used with a ResilientOperation.

Field Summary

Fields

Modifier and Type	Field and Description
static RetryDeterminer<Exception>	DEFAULT Retries when either SOCKET_ERRORS or SERVER_ERRORS would retry.
static RetryDeterminer<IOException>	RATE_LIMIT_ERRORS A rate limited determiner that uses a generic ApiErrorExtractor.
static RetryDeterminer<IOException>	SERVER_ERRORS Server errors RetryDeterminer decides to retry on HttpResponseExceptions that return a 500.
static RetryDeterminer<IOException>	SOCKET_ERRORS Socket errors retry determiner retries on socket exceptions.

Constructor Summary

Constructors

Constructor and Description
RetryDeterminer()

Method Summary

Modifier and Type	Method and Description
static RetryDeterminer<IOException>	createRateLimitedRetryDeterminer(ApiErrorExtractor errorExtractor) A RetryDeterminer that retries on rate limited errors as determined by the provided ApiErrorExtractor.
abstract boolean	shouldRetry(X e) Determines if we should attempt a retry depending on the caught exception.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT

public static final RetryDeterminer<Exception> DEFAULT

Retries when either SOCKET_ERRORS or SERVER_ERRORS would retry.

SOCKET_ERRORS

public static final RetryDeterminer<IOException> SOCKET_ERRORS

Socket errors retry determiner retries on socket exceptions.

SERVER_ERRORS

public static final RetryDeterminer<IOException> SERVER_ERRORS

Server errors RetryDeterminer decides to retry on HttpResponseExceptions that return a 500.

RATE_LIMIT_ERRORS

public static final RetryDeterminer<IOException> RATE_LIMIT_ERRORS

A rate limited determiner that uses a generic ApiErrorExtractor.

Constructor Detail

RetryDeterminer

public RetryDeterminer()

Method Detail

shouldRetry

public abstract boolean shouldRetry(X e)

Determines if we should attempt a retry depending on the caught exception.

To indicate that no retry should be made, return false. If no retry, the exception should be returned to the user.

Parameters:

e - Exception of type X that can be examined to determine if a retry is possible.

Returns:

true if should retry, false otherwise

createRateLimitedRetryDeterminer

public static RetryDeterminer<IOException> createRateLimitedRetryDeterminer(ApiErrorExtractor errorExtractor)

A RetryDeterminer that retries on rate limited errors as determined by the provided ApiErrorExtractor.

Parameters:

errorExtractor - The ApiErrorExtractor that will determine if it is rate limited.