Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

CompletableFuture.join(): získání výsledku

`join()` získá výsledek objektu `CompletableFuture` a v případě potřeby počká na jeho dokončení. Nedeklaruje kontrolované výjimky, ale může vyvolat nekontrolovanou výjimku.

Verze: Java SE 21

Syntaxe

public T join()

V Javě SE 21 je CompletableFuture.join() bezargumentová metoda instance třídy java.util.concurrent.CompletableFuture<T>. Pokud objekt ještě není dokončen, volání blokuje aktuální vlákno až do dokončení. Při normálním dokončení vrátí výsledek typu T; pokud je výsledek už k dispozici, nečeká.

Pokud výpočet selže, join() vyvolá CompletionException a příčinu lze zjistit pomocí getCause(). Pokud byl zrušen samotný objekt, join() vyvolá přímo CancellationException. Obě výjimky jsou nekontrolované: překladač nevyžaduje jejich zachycení ani deklaraci.

Na rozdíl od join() metoda get() při přerušení čekání vyvolá kontrolovanou výjimku InterruptedException a selhání výpočtu hlásí kontrolovanou výjimkou ExecutionException. join() neukončuje čekání vyvoláním InterruptedException a nepřijímá časový limit; pro čekání s limitem použij get(timeout, unit). Naproti tomu Thread.join() čeká na ukončení vlákna, nevrací výsledek výpočtu (void) a deklaruje InterruptedException.

Pří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ýsledek

42
failure: invalid input
cancelled

Každý objekt `CompletableFuture` je dokončen už před voláním `join()`. Příklad ukazuje hodnotu `42`, zprávu o příčině selhání a přímo vyvolanou výjimku `CancellationException`; blokování neukazuje.

Související lekce

  • Java · Lekce 51 · Středně pokročilá · Verze: 2

Zdroje