org.jodconverter.core.office

Class AbstractRetryable<T extends Throwable>

java.lang.Object

org.jodconverter.core.office.AbstractRetryable<T>

public abstract class AbstractRetryable<T extends Throwable>
extends Object

Object that will attempt to execute a task until it succeeds or that a specific timeout is reached.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractRetryable() Initializes a new instance of the class.

Method Summary

Modifier and Type	Method and Description
protected abstract void	attempt() Attempt to execute the task, once.
void	execute(long interval, long timeout) Executes the task without a starting delay.
void	execute(long delay, long interval, long timeout) Executes the task without a starting delay.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractRetryable

protected AbstractRetryable()

Initializes a new instance of the class.

Method Detail

attempt

protected abstract void attempt()
                         throws TemporaryException,
                                T extends Throwable

Attempt to execute the task, once.

Throws:

TemporaryException - For an error condition that can be temporary - i.e. retrying later could be successful

T - For all other error conditions

T extends Throwable

execute

public void execute(long interval,
                    long timeout)
             throws RetryTimeoutException,
                    T extends Throwable

Executes the task without a starting delay.

Parameters:

interval - The interval between each task execution attempt.

timeout - The timeout after which we won't try again to execute the task.

Throws:

RetryTimeoutException - If this Retryable fails to complete its task in the given time.

T - For all other error conditions.

T extends Throwable

execute

public void execute(long delay,
                    long interval,
                    long timeout)
             throws RetryTimeoutException,
                    T extends Throwable

Executes the task without a starting delay.

Parameters:

delay - An initial delay to wait for before the first attempt.

interval - The interval between each task execution attempt.

timeout - The timeout after which we won't try again to execute the task.

Throws:

RetryTimeoutException - If this Retryable fails to complete its task in the given time.

T - For all other error conditions.

T extends Throwable