## 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`.

Copyright © 2009 The Apache Software Foundation