org.apache.hadoop.io.retry (Hadoop 1.2.1 API)
Date: 2013-07-22

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES

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

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES

Copyright © 2009 The Apache Software Foundation