org.apache.hadoop.io.retry (Hadoop 0.20.1+169.127 API)
Date: 2011-01-16

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

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

Copyright © 2009 The Apache Software Foundation