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