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.
RetryProxy	A factory for creating retry proxies.

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.