me.alexpanov.retries

Class Retries<Result>

java.lang.Object

me.alexpanov.retries.Retries<Result>

Type Parameters:

Result -

public final class Retries<Result>
extends Object

Allows specification of retry strategy to repeat calls to a function unless all of the conditions are met. Null results are skipped and other skip critera can be specified through predicates. If no acceptable value is returned a default value will be returned if specified. Default number of retries is 2.

Constructor Summary

Constructors

Constructor and Description
Retries(Retryable<Result> retryable) Main constructor

Method Summary

Modifier and Type	Method and Description
Retries<Result>	ignoreIfResult(com.google.common.base.Predicate<? super Result> matches) Specify a skip condition to discard values returned by the Retryable.
Retries<Result>	onEachFailureDo(FailureSubscriber<Result> failureSubscriber) Perform an arbitrary action after each failed repetition.
Retries<Result>	orElse(Result value) Specify a default value to return if maximum number repetitions was reached and no satisfactory value was computed.
Result	perform() Carry out the retries.
Future<Result>	performAsync() Carry out the retries asynchronously.
Retries<Result>	stopOnMaxFailures(int maxRetries) Specify the maximum number of executions.
Retries<Result>	waitAfterFailureAtLeast(int timeout, TimeUnit timeUnit) Specify a timeout to wait after each failed repetition.

Methods inherited from class java.lang.Object

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

Constructor Detail

Retries

public Retries(Retryable<Result> retryable)

Main constructor

Parameters:

retryable - to execute

Method Detail

stopOnMaxFailures

public Retries<Result> stopOnMaxFailures(int maxRetries)

Specify the maximum number of executions.

orElse

public Retries<Result> orElse(Result value)

Specify a default value to return if maximum number repetitions was reached and no satisfactory value was computed.

ignoreIfResult

public Retries<Result> ignoreIfResult(com.google.common.base.Predicate<? super Result> matches)

Specify a skip condition to discard values returned by the Retryable.

onEachFailureDo

public Retries<Result> onEachFailureDo(FailureSubscriber<Result> failureSubscriber)

Perform an arbitrary action after each failed repetition.

waitAfterFailureAtLeast

public Retries<Result> waitAfterFailureAtLeast(int timeout,
                                               TimeUnit timeUnit)

Specify a timeout to wait after each failed repetition.

perform

public Result perform()
               throws RetryException

Carry out the retries.

Throws:

RetryException - if no satisfactory value was computed and no default value was provided.

performAsync

public Future<Result> performAsync()

Carry out the retries asynchronously.

Throws:

RetryException - if no satisfactory value was computed and no default value was provided.