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

CKTIS / Java

CompletableFuture.join(): získanie výsledku

`join()` získa výsledok objektu `CompletableFuture` a v prípade potreby počká na jeho dokončenie. Nedeklaruje kontrolované výnimky, ale môže vyvolať nekontrolovanú výnimku.

Verzia: Java SE 21

Syntax

public T join()

V Jave SE 21 je CompletableFuture.join() inštančná metóda bez argumentov triedy java.util.concurrent.CompletableFuture<T>. Ak objekt ešte nie je dokončený, volanie blokuje aktuálne vlákno až do dokončenia. Pri normálnom dokončení vráti výsledok typu T; ak je výsledok už dostupný, nečaká.

Ak výpočet zlyhá, join() vyvolá CompletionException a príčinu možno zistiť pomocou getCause(). Ak bol zrušený samotný objekt, join() vyvolá priamo CancellationException. Obe výnimky sú nekontrolované: kompilátor nevyžaduje ich zachytenie ani deklarovanie.

Na rozdiel od join() metóda get() pri prerušení čakania vyvolá kontrolovanú výnimku InterruptedException a zlyhanie výpočtu hlási kontrolovanou výnimkou ExecutionException. join() neukončuje čakanie vyvolaním InterruptedException a neprijíma časový limit; na časovo obmedzené čakanie použi get(timeout, unit). Thread.join() naopak čaká na skončenie vlákna, nevracia výsledok výpočtu (void) a deklaruje InterruptedException.

Príklady

import java.util.concurrent.CancellationException;
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.CompletionException;

public class Main {
    public static void main(String[] args) {
        CompletableFuture<Integer> success = CompletableFuture.completedFuture(42);
        System.out.println(success.join());

        CompletableFuture<Integer> failure =
                CompletableFuture.failedFuture(new IllegalArgumentException("invalid input"));
        try {
            failure.join();
        } catch (CompletionException e) {
            System.out.println("failure: " + e.getCause().getMessage());
        }

        CompletableFuture<Integer> cancelled = new CompletableFuture<>();
        cancelled.cancel(false);
        try {
            cancelled.join();
        } catch (CancellationException e) {
            System.out.println("cancelled");
        }
    }
}

Výsledok

42
failure: invalid input
cancelled

Každý objekt `CompletableFuture` je dokončený už pred volaním `join()`. Príklad ukazuje hodnotu `42`, správu o príčine zlyhania a priamo vyvolanú výnimku `CancellationException`; blokovanie neukazuje.

Súvisiace lekcie

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

Zdroje