Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

`CompletableFuture.thenCombine`: łączenie dwóch wyników

`thenCombine` tworzy nowy `CompletableFuture` i oblicza jego wartość dopiero po pomyślnym zakończeniu obu etapów — na przykład sumuje wartości dwóch niezależnych liczników.

Wersja: Java SE 21

Składnia

public <U, V> CompletableFuture<V> thenCombine(CompletionStage<? extends U> other, BiFunction<? super T, ? super U, ? extends V> fn)

CompletableFuture.thenCombine rejestruje funkcję fn zależną od dwóch etapów. Wywołanie left.thenCombine(right, fn) nie uruchamia obliczeń wejściowych ani nie blokuje w oczekiwaniu na ich wyniki. fn może wykonać się dopiero po pomyślnym zakończeniu obu etapów. Pierwszy argument funkcji pochodzi z left, a drugi z right, niezależnie od kolejności zakończenia etapów.

T to typ wyniku left, a U to typ wyniku drugiego etapu; nie muszą być takie same. right może być dowolnym zgodnym CompletionStage, niekoniecznie CompletableFuture. Wartość zwrócona przez BiFunction staje się wynikiem typu V nowego CompletableFuture<V>. Użyj thenCompose, gdy dopiero wynik pierwszego etapu pozwala wybrać lub uruchomić następny etap.

Wariant bez Async nie gwarantuje osobnego wątku. Jeśli oba wyniki są już dostępne, funkcja może wykonać się jeszcze przed powrotem z thenCombine. thenCombineAsync(other, fn) korzysta z domyślnego mechanizmu wykonania asynchronicznego, a thenCombineAsync(other, fn, executor) używa przekazanego Executor.

Jeśli którykolwiek etap wejściowy zakończy się wyjątkiem, także wskutek anulowania, fn nie zostanie wywołana. W OpenJDK 21 thenCombine czeka na zakończenie obu etapów wejściowych, zanim zakończy etap zależny wyjątkiem. Jeśli drugi etap nigdy się nie zakończy, etap zależny może pozostać nieukończony bezterminowo. Jeśli oba etapy zawiodą, zgłoszona przyczyna może pochodzić z dowolnego z nich. Wyjątek rzucony przez fn również kończy etap zależny wyjątkowo; odczyt takiego wyniku przez join() zgłasza CompletionException.

Przykłady

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());
    }
}

Wynik

false
42

`rightCount` kończy się jako pierwszy, ale `total.isDone()` nadal zwraca `false`. Dopiero po zakończeniu `leftCount` funkcja `Integer::sum` otrzymuje `18` i `24`, a `total.join()` zwraca `42`.

Powiązane lekcje

  • Java · Lekcja 51 · Średniozaawansowany · Wersja: 2

Źródła