org.arp.javautil.io

Interface Retryable<E>

Type Parameters:

E - the type of error code or exception that occurs when the operation fails.

public interface Retryable<E>

Adds support for automatically retrying an operation whose failure is expected under defined circumstances. This enables fault tolerance for data access operations.

Author:

Andrew Post

Method Summary

Modifier and Type	Method and Description
E	attempt() Attempts to execute an operation that may fail under defined circumstances.
void	recover() Performs some operation between attempts (e.g., wait for a few seconds).

Method Detail

attempt

E attempt()

Attempts to execute an operation that may fail under defined circumstances.

Returns:

an error code or exception, or null if the attempt is successful. Exceptions are returned not thrown so that the type of error can be specified using generics (throw E causes a compile-time error).

recover

void recover()

Performs some operation between attempts (e.g., wait for a few seconds). This will not be called after the last attempt. Use the attempt() method for resource cleanup.