Introduction
SmallRye Fault Tolerance comprises the following main artifacts:
-
io.smallrye:smallrye-fault-tolerance-api
: public API for the features provided on top of MicroProfile Fault Tolerance, including a programmatic API; -
io.smallrye:smallrye-fault-tolerance-core
: core implementations of fault tolerance strategies; -
io.smallrye:smallrye-fault-tolerance
: CDI-based implementation of MicroProfile Fault Tolerance with SmallRye Fault Tolerance extensions, including a programmatic API; -
io.smallrye:smallrye-fault-tolerance-autoconfig-core
: runtime part of the SmallRye Fault Tolerance configuration system.-
(There’s also
io.smallrye:smallrye-fault-tolerance-autoconfig-processor
, but that is only used during SmallRye Fault Tolerance build and isn’t required at runtime.)
-
These artifacts must be always present, together with the following dependencies:
-
Jakarta CDI, Annotations and Interceptors API;
-
org.eclipse.microprofile.fault-tolerance:microprofile-fault-tolerance-api
; -
org.eclipse.microprofile.config:microprofile-config-api
and some implementation; -
org.eclipse.microprofile.metrics:microprofile-metrics-api
and some implementation (implementation is only required if fault tolerance metrics are enabled); -
org.jboss.logging:jboss-logging
.
Some other artifacts are provided to facilitate additional integrations. These are described in the subsequent sections.
Most of the integration is performed automatically by the CDI Portable Extension present in SmallRye Fault Tolerance: io.smallrye.faulttolerance.FaultToleranceExtension
.
Make sure the extension is active.
The remaining integration concerns are described in the following sections:
-
providing a thread pool for
@Asynchronous
methods and other asynchronous tasks; -
enabling Context Propagation for
@Asynchronous
methods; -
enabling OpenTracing integration with Context Propagation;
-
integrating an event loop for non-blocking method invocations;
-
integrating additional types for asynchronous invocations;
-
integrating the programmatic API that SmallRye Fault Tolerance provides.
Standalone Implementation of the Programmatic API
A completely standalone implementation of the programmatic API exists in the io.smallrye:smallrye-fault-tolerance-standalone
artifact.
This is supposed to be used in a non-CDI environment.
Runtimes that integrate SmallRye Fault Tolerance typically do so using CDI, and so should ignore this artifact.