org.dataone.client

Class RetryHandler<V>

java.lang.Object

org.dataone.client.RetryHandler<V>

public abstract class RetryHandler<V>
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RetryHandler.TryAgainException

Constructor Summary

Constructors

Constructor and Description
RetryHandler()

Method Summary

Modifier and Type	Method and Description
protected abstract V	attempt() the task to attempt
V	execute(long interval, long duration) Executes the attempt() method at regular intervals until no exception is raised, or the duration has been reached.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RetryHandler

public RetryHandler()

Method Detail

execute

public V execute(long interval,
                 long duration)
          throws Exception

Executes the attempt() method at regular intervals until no exception is raised, or the duration has been reached.

Parameters:

interval - - milliseconds between attempts

duration - - the maximum number of milliseconds to try getting the desired result.

Returns:

Throws:

Exception

attempt

protected abstract V attempt()
                      throws RetryHandler.TryAgainException,
                             Exception

the task to attempt

Returns:

Throws:

RetryHandler.TryAgainException - - should be thrown by implementations for non-successful attempts where a retry is warranted

Exception - - all other exceptions. Will immediately exit the retry logic