io.github.resilience4j.retry.configure

Class RetryAspect

java.lang.Object

io.github.resilience4j.retry.configure.RetryAspect

All Implemented Interfaces:

org.springframework.beans.factory.Aware, org.springframework.context.EmbeddedValueResolverAware, org.springframework.core.Ordered

public class RetryAspect
extends java.lang.Object
implements org.springframework.context.EmbeddedValueResolverAware, org.springframework.core.Ordered

This Spring AOP aspect intercepts all methods which are annotated with a Retry annotation. The aspect will handle methods that return a RxJava2 reactive type, Spring Reactor reactive type, CompletionStage type, or value type.

The RetryRegistry is used to retrieve an instance of a Retry for a specific name.

Given a method like this:

      @Retry(name = "myService")
     public String fancyName(String name) {
         return "Sir Captain " + name;
     }
 

each time the #fancyName(String) method is invoked, the method's execution will pass through a a Retry according to the given config.

The fallbackMethod parameter signature must match either:

1) The method parameter signature on the annotated method or 2) The method parameter signature with a matching exception type as the last parameter on the annotated method

Field Summary

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor and Description
RetryAspect(RetryConfigurationProperties retryConfigurationProperties, io.github.resilience4j.retry.RetryRegistry retryRegistry, java.util.List<RetryAspectExt> retryAspectExtList, FallbackDecorators fallbackDecorators)

Method Summary

Modifier and Type	Method and Description
int	getOrder()
void	matchAnnotatedClassOrMethod(io.github.resilience4j.retry.annotation.Retry retry)
java.lang.Object	retryAroundAdvice(org.aspectj.lang.ProceedingJoinPoint proceedingJoinPoint, io.github.resilience4j.retry.annotation.Retry retryAnnotation)
void	setEmbeddedValueResolver(org.springframework.util.StringValueResolver resolver)

Methods inherited from class java.lang.Object

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

Constructor Detail

RetryAspect

public RetryAspect(RetryConfigurationProperties retryConfigurationProperties,
                   io.github.resilience4j.retry.RetryRegistry retryRegistry,
                   @Autowired(required=false)
                   java.util.List<RetryAspectExt> retryAspectExtList,
                   FallbackDecorators fallbackDecorators)

Parameters:

retryConfigurationProperties - spring retry config properties

retryRegistry - retry definition registry

retryAspectExtList - a list of retry aspect extensions

fallbackDecorators - the fallback decorators

Method Detail

matchAnnotatedClassOrMethod

public void matchAnnotatedClassOrMethod(io.github.resilience4j.retry.annotation.Retry retry)

retryAroundAdvice

public java.lang.Object retryAroundAdvice(org.aspectj.lang.ProceedingJoinPoint proceedingJoinPoint,
                                          @Nullable
                                          io.github.resilience4j.retry.annotation.Retry retryAnnotation)
                                   throws java.lang.Throwable

Throws:

java.lang.Throwable

getOrder

public int getOrder()

Specified by:

getOrder in interface org.springframework.core.Ordered

setEmbeddedValueResolver

public void setEmbeddedValueResolver(org.springframework.util.StringValueResolver resolver)

Specified by:

setEmbeddedValueResolver in interface org.springframework.context.EmbeddedValueResolverAware