com.google.cloud.storage.contrib.nio

Class CloudStorageRetryHandler

java.lang.Object

com.google.cloud.storage.contrib.nio.CloudStorageRetryHandler

public class CloudStorageRetryHandler
extends Object

Simple counter class to keep track of retry and reopen attempts when StorageExceptions are encountered. Handles sleeping between retry/reopen attempts, as well as throwing an exception when all retries/reopens are exhausted.

Constructor Summary

Constructors

Constructor and Description
CloudStorageRetryHandler(int maxRetriesAndReopens) Create a CloudStorageRetryHandler with the maximum retries and reopens set to the same value.
CloudStorageRetryHandler(int maxRetries, int maxReopens) Create a CloudStorageRetryHandler with the maximum retries and reopens set to different values.

Method Summary

Modifier and Type	Method and Description
boolean	handleStorageException(StorageException exs) Checks whether we should retry, reopen, or give up.
int	reopens()
int	retries()

Methods inherited from class java.lang.Object

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

Constructor Detail

CloudStorageRetryHandler

public CloudStorageRetryHandler(int maxRetriesAndReopens)

Create a CloudStorageRetryHandler with the maximum retries and reopens set to the same value.

Parameters:

maxRetriesAndReopens - value for both maxRetries and maxReopens

CloudStorageRetryHandler

public CloudStorageRetryHandler(int maxRetries,
                                int maxReopens)

Create a CloudStorageRetryHandler with the maximum retries and reopens set to different values.

Parameters:

maxRetries - maximum number of retries

maxReopens - maximum number of reopens

Method Detail

retries

public int retries()

Returns:

number of retries we've performed

reopens

public int reopens()

Returns:

number of reopens we've performed

handleStorageException

public boolean handleStorageException(StorageException exs)
                               throws StorageException

Checks whether we should retry, reopen, or give up. In the latter case it throws an exception (this includes the scenario where we exhausted the retry count). Otherwise, it sleeps for a bit and returns whether we should reopen. The sleep time is dependent on the retry number.

Parameters:

exs - caught StorageException

Returns:

True if you need to reopen and then try again. False if you can just try again.

Throws:

StorageException - if the exception is not retryable, or if you ran out of retries.