RetryPolicy (Recurrent 0.7.1 API)

java.lang.Object
- net.jodah.recurrent.RetryPolicy

```
public final class RetryPolicy
extends Object
```
A policy that defines when retries should be performed.
The retryOn methods describe when a retry should be performed for a particular failure. The retryWhen method describes when a retry should be performed for a particular result. If multiple retryOn or retryWhen conditions are specified, any matching condition can allow a retry. The abortOn, abortWhen and abortIf methods describe when retries should be aborted.

Constructor Summary

Constructors
Constructor and Description

RetryPolicy()
Creates a retry policy that always retries with no delay.

RetryPolicy(RetryPolicy rp)
Copy constructor.

Constructors
Constructor and Description
`RetryPolicy()` Creates a retry policy that always retries with no delay.
`RetryPolicy(RetryPolicy rp)` Copy constructor.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`<T> RetryPolicy`	`abortIf(BiPredicate<T,? extends Throwable> completionPredicate)` Specifies that retries should be aborted if the `completionPredicate` matches the completion result.
`<T> RetryPolicy`	`abortIf(Predicate<T> resultPredicate)` Specifies that retries should be aborted if the `resultPredicate` matches the result.
`RetryPolicy`	`abortOn(Class<? extends Throwable>... failures)` Specifies when retries should be aborted.
`RetryPolicy`	`abortOn(List<Class<? extends Throwable>> failures)` Specifies when retries should be aborted.
`RetryPolicy`	`abortOn(Predicate<? extends Throwable> failurePredicate)` Specifies that retries should be aborted if the `failurePredicate` matches the failure.
`RetryPolicy`	`abortWhen(Object result)` Specifies that retries should be aborted if the execution result matches the `result`.
`boolean`	`allowsRetries()` Returns whether the policy allows any retries based on the configured maxRetries and maxDuration.
`boolean`	`allowsRetriesFor(Object result, Throwable failure)` Returns whether the policy will allow retries for the `failure`.
`RetryPolicy`	`copy()` Returns a copy of this RetryPolicy.
`Duration`	`getDelay()` Returns the delay between retries.
`double`	`getDelayMultiplier()` Returns the delay multiplier for backoff retries.
`Duration`	`getMaxDelay()` Returns the max delay between backoff retries.
`Duration`	`getMaxDuration()` Returns the max duration to perform retries for.
`int`	`getMaxRetries()` Returns the max retries.
`<T> RetryPolicy`	`retryIf(BiPredicate<T,? extends Throwable> completionPredicate)` Specifies that a retry should occur if the `completionPredicate` matches the completion result and the retry policy is not exceeded.
`<T> RetryPolicy`	`retryIf(Predicate<T> resultPredicate)` Specifies that a retry should occur if the `resultPredicate` matches the result and the retry policy is not exceeded.
`RetryPolicy`	`retryOn(Class<? extends Throwable>... failures)` Specifies the failures to retry on.
`RetryPolicy`	`retryOn(List<Class<? extends Throwable>> failures)` Specifies the failures to retry on.
`RetryPolicy`	`retryOn(Predicate<? extends Throwable> failurePredicate)` Specifies that a retry should occur if the `failurePredicate` matches the failure and the retry policy is not exceeded.
`RetryPolicy`	`retryWhen(Object result)` Specifies that a retry should occur if the execution result matches the `result` and the retry policy is not exceeded.
`RetryPolicy`	`withBackoff(long delay, long maxDelay, TimeUnit timeUnit)` Sets the `delay` between retries, exponentially backing of to the `maxDelay` and multiplying successive delays by a factor of 2.
`RetryPolicy`	`withBackoff(long delay, long maxDelay, TimeUnit timeUnit, double delayMultiplier)` Sets the `delay` between retries, exponentially backing of to the `maxDelay` and multiplying successive delays by the `delayMultiplier`.
`RetryPolicy`	`withDelay(long delay, TimeUnit timeUnit)` Sets the `delay` between retries.
`RetryPolicy`	`withMaxDuration(long maxDuration, TimeUnit timeUnit)` Sets the max duration to perform retries for.
`RetryPolicy`	`withMaxRetries(int maxRetries)` Sets the max number of retries to perform.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - RetryPolicy
```
public RetryPolicy()
```
    Creates a retry policy that always retries with no delay.
  - RetryPolicy
```
public RetryPolicy(RetryPolicy rp)
```
    Copy constructor.
- Method Detail
  - allowsRetries
```
public boolean allowsRetries()
```
    Returns whether the policy allows any retries based on the configured maxRetries and maxDuration.
  - allowsRetriesFor
```
public boolean allowsRetriesFor(Object result,
                                Throwable failure)
```
    Returns whether the policy will allow retries for the failure.
  - copy
```
public RetryPolicy copy()
```
    Returns a copy of this RetryPolicy.
  - getDelay
```
public Duration getDelay()
```
    Returns the delay between retries. Defaults to Duration.NONE.
    
    See Also:
    
    withDelay(long, TimeUnit), withBackoff(long, long, TimeUnit), withBackoff(long, long, TimeUnit, double)
  - getDelayMultiplier
```
public double getDelayMultiplier()
```
    Returns the delay multiplier for backoff retries.
    
    See Also:
    
    withBackoff(long, long, TimeUnit, double)
  - getMaxDelay
```
public Duration getMaxDelay()
```
    Returns the max delay between backoff retries.
    
    See Also:
    
    withBackoff(long, long, TimeUnit)
  - getMaxDuration
```
public Duration getMaxDuration()
```
    Returns the max duration to perform retries for.
    
    See Also:
    
    withMaxDuration(long, TimeUnit)
  - getMaxRetries
```
public int getMaxRetries()
```
    Returns the max retries. Defaults to -1, which retries forever.
    
    See Also:
    
    withMaxRetries(int)
  - abortOn
```
public RetryPolicy abortOn(Class<? extends Throwable>... failures)
```
    Specifies when retries should be aborted. Any failure that is assignable from the failures will be result in retries being aborted.
    
    Throws:
    
    NullPointerException - if failures is null
    
    IllegalArgumentException - if failures is empty
  - abortOn
```
public RetryPolicy abortOn(List<Class<? extends Throwable>> failures)
```
    Specifies when retries should be aborted. Any failure that is assignable from the failures will be result in retries being aborted.
    
    Throws:
    
    NullPointerException - if failures is null
    
    IllegalArgumentException - if failures is empty
  - abortOn
```
public RetryPolicy abortOn(Predicate<? extends Throwable> failurePredicate)
```
    Specifies that retries should be aborted if the failurePredicate matches the failure.
    
    Throws:
    
    NullPointerException - if failurePredicate is null
  - abortIf
```
public <T> RetryPolicy abortIf(BiPredicate<T,? extends Throwable> completionPredicate)
```
    Specifies that retries should be aborted if the completionPredicate matches the completion result.
    
    Throws:
    
    NullPointerException - if completionPredicate is null
  - abortIf
```
public <T> RetryPolicy abortIf(Predicate<T> resultPredicate)
```
    Specifies that retries should be aborted if the resultPredicate matches the result.
    
    Throws:
    
    NullPointerException - if resultPredicate is null
  - abortWhen
```
public RetryPolicy abortWhen(Object result)
```
    Specifies that retries should be aborted if the execution result matches the result.
  - retryOn
```
public RetryPolicy retryOn(Class<? extends Throwable>... failures)
```
    Specifies the failures to retry on. Any failure that is assignable from the failures will be retried.
    
    Throws:
    
    NullPointerException - if failures is null
    
    IllegalArgumentException - if failures is empty
  - retryOn
```
public RetryPolicy retryOn(List<Class<? extends Throwable>> failures)
```
    Specifies the failures to retry on. Any failure that is assignable from the failures will be retried.
    
    Throws:
    
    NullPointerException - if failures is null
    
    IllegalArgumentException - if failures is empty
  - retryOn
```
public RetryPolicy retryOn(Predicate<? extends Throwable> failurePredicate)
```
    Specifies that a retry should occur if the failurePredicate matches the failure and the retry policy is not exceeded.
    
    Throws:
    
    NullPointerException - if failurePredicate is null
  - retryIf
```
public <T> RetryPolicy retryIf(BiPredicate<T,? extends Throwable> completionPredicate)
```
    Specifies that a retry should occur if the completionPredicate matches the completion result and the retry policy is not exceeded.
    
    Throws:
    
    NullPointerException - if completionPredicate is null
  - retryIf
```
public <T> RetryPolicy retryIf(Predicate<T> resultPredicate)
```
    Specifies that a retry should occur if the resultPredicate matches the result and the retry policy is not exceeded.
    
    Throws:
    
    NullPointerException - if resultPredicate is null
  - retryWhen
```
public RetryPolicy retryWhen(Object result)
```
    Specifies that a retry should occur if the execution result matches the result and the retry policy is not exceeded.
  - withBackoff
```
public RetryPolicy withBackoff(long delay,
                               long maxDelay,
                               TimeUnit timeUnit)
```
    Sets the delay between retries, exponentially backing of to the maxDelay and multiplying successive delays by a factor of 2.
    
    Throws:
    
    NullPointerException - if timeUnit is null
    
    IllegalArgumentException - if delay is <= 0 or delay is >= maxDelay
  - withBackoff
```
public RetryPolicy withBackoff(long delay,
                               long maxDelay,
                               TimeUnit timeUnit,
                               double delayMultiplier)
```
    Sets the delay between retries, exponentially backing of to the maxDelay and multiplying successive delays by the delayMultiplier.
    
    Throws:
    
    NullPointerException - if timeUnit is null
    
    IllegalStateException - if delay is >= the maxDuration
    
    IllegalArgumentException - if delay <= 0, delay is >= maxDelay, or the delayMultiplier is <= 1
  - withDelay
```
public RetryPolicy withDelay(long delay,
                             TimeUnit timeUnit)
```
    Sets the delay between retries.
    
    Throws:
    
    NullPointerException - if timeUnit is null
    
    IllegalArgumentException - if delay <= 0
    
    IllegalStateException - if delay is >= the maxDuration
  - withMaxDuration
```
public RetryPolicy withMaxDuration(long maxDuration,
                                   TimeUnit timeUnit)
```
    Sets the max duration to perform retries for.
    
    Throws:
    
    NullPointerException - if timeUnit is null
    
    IllegalStateException - if maxDuration is <= the delay
  - withMaxRetries
```
public RetryPolicy withMaxRetries(int maxRetries)
```
    Sets the max number of retries to perform. -1 indicates to retry forever.
    
    Throws:
    
    IllegalArgumentException - if maxRetries < -1

Class RetryPolicy

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

RetryPolicy

RetryPolicy

Method Detail

allowsRetries

allowsRetriesFor

copy

getDelay

getDelayMultiplier

getMaxDelay

getMaxDuration

getMaxRetries

abortOn

abortOn

abortOn

abortIf

abortIf

abortWhen

retryOn

retryOn

retryOn

retryIf

retryIf

retryWhen

withBackoff

withBackoff

withDelay

withMaxDuration

withMaxRetries