CKTIS / Java
`CompletableFuture.thenCombine`: spojení dvou výsledků
`thenCombine` vytvoří nový `CompletableFuture`, jehož hodnota se vypočítá až po úspěšném dokončení obou vstupních etap, například sečtením hodnot dvou nezávislých počítadel.
Verze: Java SE 21
Syntaxe
public <U, V> CompletableFuture<V> thenCombine(CompletionStage<? extends U> other, BiFunction<? super T, ? super U, ? extends V> fn)CompletableFuture.thenCombine zaregistruje funkci fn, která závisí na dvou etapách. Volání left.thenCombine(right, fn) nespouští vstupní výpočty ani neblokuje vlákno čekáním na jejich výsledky. fn se může spustit až po úspěšném dokončení obou etap. Jako první argument dostane výsledek left a jako druhý výsledek right bez ohledu na pořadí dokončení.
T je typ výsledku left a U je typ výsledku druhé etapy; mohou se lišit. right může být libovolný kompatibilní CompletionStage, nemusí to být CompletableFuture. Hodnota vrácená funkcí BiFunction se stane výsledkem typu V v novém CompletableFuture<V>. Použijte thenCompose, pokud první výsledek potřebujete k výběru nebo spuštění další etapy.
Varianta bez Async nezaručuje samostatné vlákno. Jsou-li oba výsledky již dostupné, funkce se může vykonat ještě před návratem z thenCombine. thenCombineAsync(other, fn) používá výchozí mechanismus asynchronního vykonávání, zatímco thenCombineAsync(other, fn, executor) používá předaný Executor.
Pokud některá vstupní etapa skončí výjimkou, a to i při zrušení, fn se nezavolá. V OpenJDK 21 thenCombine čeká, až skončí obě vstupní etapy, než závislou etapu ukončí výjimkou. Pokud druhá vstupní etapa nikdy neskončí, závislá etapa může zůstat nedokončená neomezeně dlouho. Selžou-li obě, oznámená příčina může pocházet z kterékoli z nich. Výjimka vyhozená funkcí fn rovněž způsobí selhání závislé etapy; při získávání takového výsledku vyhodí join() výjimku CompletionException.
Příklady
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());
}
}Výsledek
false 42
`rightCount` se dokončí jako první, ale `total.isDone()` stále vrací `false`. Teprve po dokončení `leftCount` obdrží `Integer::sum` hodnoty `18` a `24` a `total.join()` vrátí `42`.
Související lekce
- Java · Lekce 51 · Středně pokročilá · Verze: 2