com.symphony.bdk.core.retry.resilience4j

Class Resilience4jRetryWithRecovery<T>

java.lang.Object

com.symphony.bdk.core.retry.RetryWithRecovery<T>

com.symphony.bdk.core.retry.resilience4j.Resilience4jRetryWithRecovery<T>

Type Parameters:

T - the type of the object returned by execute()

@API(status=INTERNAL)
public class Resilience4jRetryWithRecovery<T>
extends RetryWithRecovery<T>

This class aims to implement a retry mechanism (on top of aRetry) with different recovery strategies based on predicates.

Constructor Summary

Constructors

Constructor and Description
Resilience4jRetryWithRecovery(java.lang.String name, java.lang.String address, BdkRetryConfig bdkRetryConfig, SupplierWithApiException<T> supplier, java.util.function.Predicate<java.lang.Throwable> retryOnExceptionPredicate, java.util.List<RecoveryStrategy> recoveryStrategies) Constructor with no predicate on when to ignore an ApiException, i.e.
Resilience4jRetryWithRecovery(java.lang.String name, java.lang.String address, BdkRetryConfig bdkRetryConfig, SupplierWithApiException<T> supplier, java.util.function.Predicate<java.lang.Throwable> retryOnExceptionPredicate, java.util.function.Predicate<java.lang.Exception> ignoreException, java.util.List<RecoveryStrategy> recoveryStrategies) Constructor with a predicate on when to ignore an ApiException, i.e.

Method Summary

Modifier and Type	Method and Description
T	execute() Method called by client which should implement the retry.

Methods inherited from class com.symphony.bdk.core.retry.RetryWithRecovery

executeAndRetry, executeOnce, networkIssueMessageError

Methods inherited from class java.lang.Object

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

Constructor Detail

Resilience4jRetryWithRecovery

public Resilience4jRetryWithRecovery(java.lang.String name,
                                     java.lang.String address,
                                     BdkRetryConfig bdkRetryConfig,
                                     SupplierWithApiException<T> supplier,
                                     java.util.function.Predicate<java.lang.Throwable> retryOnExceptionPredicate,
                                     java.util.List<RecoveryStrategy> recoveryStrategies)

Constructor with no predicate on when to ignore an ApiException, i.e. ApiExceptions will never be ignored.

Parameters:

name - the name of the Retry service.

bdkRetryConfig - the retry configuration to be used.

supplier - the supplier responsible to provide the object of param type T and which may throw an ApiException.

retryOnExceptionPredicate - predicate on a thrown ApiException to know if call should be retried.

recoveryStrategies - mapping between Predicate and the corresponding recovery functions to be executed before retrying. If several predicates match, all corresponding consumers will be executed.

Resilience4jRetryWithRecovery

public Resilience4jRetryWithRecovery(java.lang.String name,
                                     java.lang.String address,
                                     BdkRetryConfig bdkRetryConfig,
                                     SupplierWithApiException<T> supplier,
                                     java.util.function.Predicate<java.lang.Throwable> retryOnExceptionPredicate,
                                     java.util.function.Predicate<java.lang.Exception> ignoreException,
                                     java.util.List<RecoveryStrategy> recoveryStrategies)

Constructor with a predicate on when to ignore an ApiException, i.e. ApiExceptions will be ignored if the predicate matches.

Parameters:

name - the name of the Retry service.

bdkRetryConfig - the retry configuration to be used.

supplier - the supplier responsible to provide the object of param type T and which may throw an ApiException.

retryOnExceptionPredicate - predicate on a thrown ApiException to know if call should be retried.

ignoreException - predicate on a thrown Exception to know if exception should be ignored, which means no subsequent retry will be made and null value will be returned.

recoveryStrategies - mapping between Predicate and the corresponding recovery functions to be executed before retrying. If several predicates match, all corresponding consumers will be executed.

Method Detail

execute

public T execute()
          throws java.lang.Throwable

Method called by client which should implement the retry. This should call RetryWithRecovery.executeOnce() which executes one actual call to the supplier, runs potential recovery actions and potentially throws an exception.

Specified by:

execute in class RetryWithRecovery<T>

Returns:

the object returned by the supplier.

Throws:

java.lang.Throwable - in case the max number of retries exhausted or if any other exception thrown by the supplier or the recovery functions.