io.smallrye.faulttolerance.core

Interface FaultToleranceStrategy<V>

Type Parameters:

V - the result type of method apply; also the result type of the guarded Callable

All Known Implementing Classes:

AsyncTimeout, BulkheadBase, CircuitBreaker, CompletionStageBulkhead, CompletionStageCircuitBreaker, CompletionStageFallback, CompletionStageRetry, CompletionStageTimeout, Fallback, FutureExecution, GeneralMetricsRecorder, Invocation, Retry, SemaphoreBulkhead, ThreadPoolBulkhead, Timeout, Tracer

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface FaultToleranceStrategy<V>

A fault tolerance strategy that guards invocations of arbitrary Callables. Fault tolerance strategies are expected to be nested; that is, implementations of this interface will typically delegate to some other FaultToleranceStrategy. The last strategy in the chain will invoke the guarded Callable; all other strategies are supposed to ignore it and just pass it down the chain. Usually, the last strategy will be Invocation.

The Callables are wrapped in an InvocationContext, which also provides support for out-of-band communication between fault tolerance strategies in a single chain.

The strategies must be thread-safe, as they are expected to be used simultaneously from multiple threads. This is important in case of strategies that maintain some state over time (such as circuit breaker).

Method Summary

Modifier and Type	Method and Description
V	apply(InvocationContext<V> ctx) Apply the fault tolerance strategy around the target Callable.

Method Detail

apply

V apply(InvocationContext<V> ctx)
 throws Exception

Apply the fault tolerance strategy around the target Callable. The Callable is wrapped in an InvocationContext.

Parameters:

ctx - the InvocationContext wrapping the Callable guarded by this fault tolerance strategy

Returns:

result computed by the target Callable

Throws:

Exception - if result couldn't be computed