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