CKTIS / Java
`CompletableFuture.thenCombine`: Zwei Ergebnisse verknüpfen
`thenCombine` erzeugt ein neues `CompletableFuture` und berechnet dessen Wert erst, wenn beide Eingabestufen erfolgreich abgeschlossen sind, etwa um zwei unabhängige Zählerstände zu addieren.
Version: Java SE 21
Syntax
public <U, V> CompletableFuture<V> thenCombine(CompletionStage<? extends U> other, BiFunction<? super T, ? super U, ? extends V> fn)CompletableFuture.thenCombine registriert eine Funktion fn, die von zwei Stufen abhängt. left.thenCombine(right, fn) startet die beiden Berechnungen nicht und blockiert auch nicht, um auf ihre Ergebnisse zu warten. fn kann erst ausgeführt werden, wenn beide Stufen erfolgreich abgeschlossen sind. Die Funktion erhält zuerst das Ergebnis von left und dann das von right, unabhängig von der Abschlussreihenfolge.
T ist der Ergebnistyp von left, U der Ergebnistyp der anderen Stufe. Die Typen dürfen sich unterscheiden. right kann ein beliebiges kompatibles CompletionStage sein und muss kein CompletableFuture sein. Der Rückgabewert der BiFunction wird zum Ergebnis vom Typ V im neuen CompletableFuture<V>. Verwende thenCompose, wenn das erste Ergebnis nötig ist, um die nächste Stufe auszuwählen oder zu starten.
Die Variante ohne Async garantiert keinen separaten Thread. Sind beide Ergebnisse bereits verfügbar, kann die Funktion noch vor der Rückkehr aus thenCombine ausgeführt werden. thenCombineAsync(other, fn) nutzt den standardmäßigen asynchronen Ausführungsmechanismus; thenCombineAsync(other, fn, executor) verwendet den übergebenen Executor.
Wird eine Eingabestufe mit einer Ausnahme abgeschlossen, auch durch Abbruch, wird fn nicht ausgeführt. In OpenJDK 21 wartet thenCombine auf den Abschluss beider Eingabestufen, bevor die abhängige Stufe mit einer Ausnahme abgeschlossen wird. Wird die andere Eingabestufe nie abgeschlossen, kann die abhängige Stufe dauerhaft offen bleiben. Schlagen beide fehl, kann die gemeldete Ursache von einer der beiden stammen. Auch eine von fn ausgelöste Ausnahme führt zum Ausnahmeabschluss der abhängigen Stufe. Beim Abrufen eines solchen Ergebnisses wirft join() eine CompletionException.
Beispiele
import java.util.concurrent.CompletableFuture;
public class CombineCounters {
public static void main(String[] args) {
var leftCount = new CompletableFuture<Integer>();
var rightCount = new CompletableFuture<Integer>();
CompletableFuture<Integer> total =
leftCount.thenCombine(rightCount, Integer::sum);
rightCount.complete(24);
System.out.println(total.isDone());
leftCount.complete(18);
System.out.println(total.join());
}
}Ergebnis
false 42
`rightCount` wird zuerst abgeschlossen, aber `total.isDone()` liefert weiterhin `false`. Erst nach Abschluss von `leftCount` erhält `Integer::sum` die Werte `18` und `24`, und `total.join()` liefert `42`.
Zugehörige Lektionen
- Java · Lektion 51 · Mittlere Stufe · Version: 2