io.micronaut.retry.annotation

Annotation Type CircuitBreaker

@Documented
 @Retention(value=RUNTIME)
 @Target(value={METHOD,TYPE,ANNOTATION_TYPE})
 @Around
 @Type(value=DefaultRetryInterceptor.class)
public @interface CircuitBreaker

Variation of Retryable that implements the Circuit Breaker pattern. Has higher overhead than Retryable as a CircuitState has to be maintained for each method call

Since:

1.0

Author:

graemerocher

Field Summary

Fields

Modifier and Type	Fields and Description
static int	MAX_RETRY_ATTEMPTS

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
@Digits(integer=4,fraction=0) java.lang.String	attempts
java.lang.String	delay
java.lang.Class<? extends java.lang.Throwable>[]	excludes
java.lang.Class<? extends java.lang.Throwable>[]	includes
java.lang.String	maxDelay The maximum overall delay for an operation to complete until the Circuit state is set to CircuitState.OPEN.
@Digits(integer=2,fraction=2) java.lang.String	multiplier
java.lang.Class<? extends RetryPredicate>	predicate
java.lang.String	reset Sets the Duration of time before resetting the circuit to CircuitState.HALF_OPEN allowing a single retry.

Field Detail

MAX_RETRY_ATTEMPTS

public static final int MAX_RETRY_ATTEMPTS

Element Detail

includes

@AliasFor(annotation=Retryable.class,
          member="includes")
public abstract java.lang.Class<? extends java.lang.Throwable>[] includes

Returns:

The exception types to include (defaults to all)

Default:

{}

excludes

@AliasFor(annotation=Retryable.class,
          member="excludes")
public abstract java.lang.Class<? extends java.lang.Throwable>[] excludes

Returns:

The exception types to exclude (defaults to none)

Default:

{}

attempts

@Digits(integer=4,
        fraction=0)
 @AliasFor(annotation=Retryable.class,
          member="attempts")
public abstract @Digits(integer=4,fraction=0) java.lang.String attempts

Returns:

The maximum number of retry attempts

Default:

"3"

delay

@AliasFor(annotation=Retryable.class,
          member="delay")
public abstract java.lang.String delay

Returns:

The delay between retry attempts

Default:

"500ms"

multiplier

@Digits(integer=2,
        fraction=2)
 @AliasFor(annotation=Retryable.class,
          member="multiplier")
public abstract @Digits(integer=2,fraction=2) java.lang.String multiplier

Returns:

The multiplier to use to calculate the delay between retries.

Default:

"0"

maxDelay

@AliasFor(annotation=Retryable.class,
          member="maxDelay")
public abstract java.lang.String maxDelay

The maximum overall delay for an operation to complete until the Circuit state is set to CircuitState.OPEN.

Returns:

The maximum overall delay

Default:

"5s"

reset

public abstract java.lang.String reset

Sets the Duration of time before resetting the circuit to CircuitState.HALF_OPEN allowing a single retry.

Returns:

The Duration of time before reset

Default:

"20s"

predicate

@AliasFor(annotation=Retryable.class,
          member="predicate")
public abstract java.lang.Class<? extends RetryPredicate> predicate

Returns:

The retry predicate class to use instead of Retryable.includes() and Retryable.excludes() (defaults to none)

Default:

io.micronaut.retry.annotation.DefaultRetryPredicate.class