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