
Fehlertoleranz-Bibliothek für Java, die Circuit Breaker, Rate Limiter, Retry, Bulkhead, Timeout und Cache-Dekoratoren für funktionale Programmierung bereitstellt.
= Fehlertoleranzbibliothek für funktionale Programmierung :author: Robert Winkler und Bohdan Storozhuk :icons: :toc: macro :numbered: 1 ifdef::env-github[] :tip-caption: 💡 :note-caption: ℹ️ :important-caption: ❗ :caution-caption: 🔥 :warning-caption: ⚠️ endif::[]
image:https://github.com/resilience4j/resilience4j/actions/workflows/gradle-build.yml/badge.svg["Build-Status"] image:https://img.shields.io/nexus/r/io.github.resilience4j/resilience4j-circuitbreaker?server=https%3A%2F%2Foss.sonatype.org["Release"] image:https://img.shields.io/nexus/s/io.github.resilience4j/resilience4j-circuitbreaker?server=https%3A%2F%2Foss.sonatype.org["Snapshot"] image:http://img.shields.io/badge/license-ASF2-blue.svg["Apache License 2", link="http://www.apache.org/licenses/LICENSE-2.0.txt"]
image:https://sonarcloud.io/api/project_badges/measure?project=resilience4j_resilience4j&metric=coverage["Abdeckung", link="https://sonarcloud.io/dashboard?id=resilience4j_resilience4j"] image:https://sonarcloud.io/api/project_badges/measure?project=resilience4j_resilience4j&metric=sqale_rating["Wartbarkeit", link="https://sonarcloud.io/dashboard?id=resilience4j_resilience4j"] image:https://sonarcloud.io/api/project_badges/measure?project=resilience4j_resilience4j&metric=reliability_rating["Zuverlässigkeit", link="https://sonarcloud.io/dashboard?id=resilience4j_resilience4j"] image:https://sonarcloud.io/api/project_badges/measure?project=resilience4j_resilience4j&metric=security_rating["Sicherheit", link="https://sonarcloud.io/dashboard?id=resilience4j_resilience4j"] image:https://sonarcloud.io/api/project_badges/measure?project=resilience4j_resilience4j&metric=vulnerabilities["Schwachstellen", link="https://sonarcloud.io/dashboard?id=resilience4j_resilience4j"] image:https://sonarcloud.io/api/project_badges/measure?project=resilience4j_resilience4j&metric=bugs["Fehler", link="https://sonarcloud.io/dashboard?id=resilience4j_resilience4j"]
toc::[]
== Einführung
Resilience4j ist eine leichtgewichtige Fehlertoleranzbibliothek, die für die funktionale Programmierung entwickelt wurde. Resilience4j bietet Funktionen höherer Ordnung (Dekoratoren), um jedes funktionale Interface, jeden Lambda-Ausdruck oder jede Methodenreferenz mit einem Circuit Breaker, Rate Limiter, Retry oder Bulkhead zu erweitern. Sie können mehr als einen Dekorator auf jedes funktionale Interface, jeden Lambda-Ausdruck oder jede Methodenreferenz stapeln. Der Vorteil ist, dass Sie die Wahl haben, nur die Dekoratoren auszuwählen, die Sie benötigen, und nichts anderes.
Resilience4j 3 erfordert Java 21.
// Create a CircuitBreaker with default configuration CircuitBreaker circuitBreaker = CircuitBreaker.ofDefaults("backendService");
// Create a Retry with default configuration // 3 retry attempts and a fixed time interval between retries of 500ms Retry retry = Retry.ofDefaults("backendService");
// Create a Bulkhead with default configuration Bulkhead bulkhead = Bulkhead.ofDefaults("backendService");
Supplier supplier = () -> backendService .doSomething(param1, param2);
// Decorate your call to backendService.doSomething() // with a Bulkhead, CircuitBreaker and Retry // **note: you will need the resilience4j-all dependency for this Supplier decoratedSupplier = Decorators.ofSupplier(supplier) .withCircuitBreaker(circuitBreaker) .withBulkhead(bulkhead) .withRetry(retry) .decorate();
// Execute the decorated supplier and recover from any exception String result = Try.ofSupplier(decoratedSupplier) .recover(throwable -> "Hello from Recovery").get();
// When you don't want to decorate your lambda expression, // but just execute it and protect the call by a CircuitBreaker. String result = circuitBreaker .executeSupplier(backendService::doSomething);
// You can also run the supplier asynchronously in a ThreadPoolBulkhead ThreadPoolBulkhead threadPoolBulkhead = ThreadPoolBulkhead .ofDefaults("backendService");
// The Scheduler is needed to schedule a timeout on a non-blocking CompletableFuture ScheduledExecutorService scheduler = Executors.newScheduledThreadPool(3); TimeLimiter timeLimiter = TimeLimiter.of(Duration.ofSeconds(1));
HINWEIS: Mit Resilience4j müssen Sie nicht alles auf einmal einsetzen, Sie können https://mvnrepository.com/artifact/io.github.resilience4j[*auswählen, was Sie brauchen*].
== Dokumentation
Einrichtung und Verwendung werden in unserem https://resilience4j.readme.io/docs[Benutzerhandbuch] beschrieben.
https://github.com/resilience4j-docs-ja/resilience4j-docs-ja[有志による日本語訳(非公式) Japanese translation by volunteers(Unofficial)]
https://github.com/lmhmhl/Resilience4j-Guides-Chinese[这是Resilience4j的非官方中文文档 Chinese translation by volunteers(Unofficial)]
== Überblick
Resilience4j bietet mehrere Kernmodule:
Es gibt außerdem Zusatzmodule für Metriken, Feign, Kotlin, Spring, Ratpack, Vertx, RxJava2 und mehr.
HINWEIS: Die vollständige Liste der Module finden Sie in unserem https://resilience4j.readme.io/docs#section-modularization[Benutzerhandbuch].
TIPP: Für das Paket der Kernmodule oder den +Decorators+-Builder siehe https://mvnrepository.com/artifact/io.github.resilience4j/resilience4j-all[resilience4j-all].
== Bewährte Vorgehensweisen
=== Instanzverwaltung: Wann Instanzen geteilt werden sollten und wann nicht
Eines der wichtigsten Konzepte, das Neueinsteiger verstehen sollten, ist, wann separate Instanzen erstellt werden sollten und wann Instanzen über verschiedene Remote-Dienste oder Backends hinweg geteilt werden sollten.
==== Warum eindeutige Instanzen wichtig sind
Das Erstellen separater Instanzen für jeden Backend-Dienst ist entscheidend für:
==== Instanzbewusste vs. nicht instanzbewusste Muster
Verschiedene Resilience-Muster haben unterschiedliche Anforderungen an die Instanzentrennung:
===== Instanzbewusste Muster (DÜRFEN NICHT geteilt werden)
Diese Muster halten Zustand, der für einen bestimmten Dienst spezifisch ist, und MÜSSEN separate Instanzen haben:
// CORRECT: Separate CircuitBreaker for each service CircuitBreaker paymentServiceCB = CircuitBreaker.ofDefaults("paymentService"); CircuitBreaker inventoryServiceCB = CircuitBreaker.ofDefaults("inventoryService"); CircuitBreaker notificationServiceCB = CircuitBreaker.ofDefaults("notificationService");