Package org.apache.hadoop.io.retry

A mechanism for selectively retrying methods that throw exceptions under certain circumstances.

See:
Description

Interface Summary

RetryPolicy

Specifies a policy for retrying method failures.

Class Summary

RetryPolicies	A collection of useful implementations of RetryPolicy.
RetryPolicies.MultipleLinearRandomRetry	Given pairs of number of retries and sleep time (n0, t0), (n1, t1), ..., the first n0 retries sleep t0 milliseconds on average, the following n1 retries sleep t1 milliseconds on average, and so on.
RetryPolicies.MultipleLinearRandomRetry.Pair	Pairs of numRetries and sleepSeconds
RetryProxy	A factory for creating retry proxies.
RetryUtils

Package org.apache.hadoop.io.retry Description

A mechanism for selectively retrying methods that throw exceptions under certain circumstances.

Typical usage is

UnreliableImplementation unreliableImpl = new UnreliableImplementation();
UnreliableInterface unreliable = (UnreliableInterface)
  RetryProxy.create(UnreliableInterface.class, unreliableImpl,
    RetryPolicies.retryUpToMaximumCountWithFixedSleep(4, 10, TimeUnit.SECONDS));
unreliable.call();

This will retry any method called on unreliable four times - in this case the call() method - sleeping 10 seconds between each retry. There are a number of retry policies available, or you can implement a custom one by implementing RetryPolicy. It is also possible to specify retry policies on a per-method basis.