Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

`CompletableFuture.thenCombine`: spojenie dvoch výsledkov

`thenCombine` vytvorí nový `CompletableFuture`, ktorého hodnota sa vypočíta až po úspešnom dokončení oboch vstupných etáp, napríklad sčítaním hodnôt dvoch nezávislých počítadiel.

Verzia: Java SE 21

Syntax

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

CompletableFuture.thenCombine zaregistruje funkciu fn, ktorá závisí od dvoch etáp. Volanie left.thenCombine(right, fn) nespúšťa vstupné výpočty ani neblokuje vlákno čakaním na ich výsledky. fn sa môže vykonať až po úspešnom dokončení oboch etáp. Ako prvý argument dostane výsledok left a ako druhý výsledok right bez ohľadu na poradie dokončenia.

T je typ výsledku left a U je typ výsledku druhej etapy; môžu sa líšiť. right môže byť ľubovoľný kompatibilný CompletionStage, nemusí to byť CompletableFuture. Hodnota, ktorú vráti BiFunction, sa stane výsledkom typu V v novom CompletableFuture<V>. Použi thenCompose, ak prvý výsledok potrebuješ na výber alebo spustenie ďalšej etapy.

Variant bez Async nezaručuje samostatné vlákno. Ak sú oba výsledky už dostupné, funkcia sa môže vykonať ešte pred návratom z thenCombine. thenCombineAsync(other, fn) používa predvolený mechanizmus asynchrónneho vykonávania, zatiaľ čo thenCombineAsync(other, fn, executor) používa odovzdaný Executor.

Ak sa niektorá vstupná etapa skončí výnimkou, a to aj pri zrušení, fn sa nezavolá. V OpenJDK 21 thenCombine čaká, kým sa skončia obe vstupné etapy, a až potom ukončí závislú etapu výnimkou. Ak sa druhá vstupná etapa nikdy neskončí, závislá etapa môže zostať nedokončená neobmedzene dlho. Ak zlyhajú obe, oznámená príčina môže pochádzať z ktorejkoľvek z nich. Výnimka vyhodená funkciou fn tiež spôsobí zlyhanie závislej etapy; pri získavaní takého výsledku vyhodí join() výnimku CompletionException.

Prí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ýsledok

false
42

`rightCount` sa dokončí ako prvý, ale `total.isDone()` stále vracia `false`. Až po dokončení `leftCount` dostane `Integer::sum` hodnoty `18` a `24` a `total.join()` vráti `42`.

Súvisiace lekcie

  • Java · Lekcia 51 · Stredne pokročilá · Verzia: 2

Zdroje