CKTIS / Java
CompletableFuture.join(): pridobivanje rezultata
`join()` pridobi rezultat objekta `CompletableFuture` in po potrebi počaka na njegov zaključek. Ne deklarira preverjanih izjem, lahko pa sproži nepreverjano izjemo.
Različica: Java SE 21
Sintaksa
public T join()V Javi SE 21 je CompletableFuture.join() metoda primerka razreda java.util.concurrent.CompletableFuture<T>, ki ne sprejema argumentov. Če objekt še ni zaključen, klic blokira trenutno nit do zaključka. Ob običajnem zaključku vrne rezultat tipa T; če je rezultat že na voljo, ne čaka.
Če izračun spodleti, join() sproži CompletionException, vzrok pa lahko preveriš z getCause(). Če je bil preklican sam objekt, join() neposredno sproži CancellationException. Obe izjemi sta nepreverjani: prevajalnik ne zahteva, da ju prestrežeš ali deklariraš.
Za razliko od join() metoda get() ob prekinitvi čakanja sproži preverjano izjemo InterruptedException, neuspeh izračuna pa sporoči s preverjano izjemo ExecutionException. join() ne konča čakanja s sprožitvijo InterruptedException in ne sprejme časovne omejitve; za časovno omejeno čakanje uporabi get(timeout, unit). Thread.join() pa čaka, da se nit konča, ne vrne rezultata izračuna (void) in deklarira InterruptedException.
Primeri
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");
}
}
}
Rezultat
42 failure: invalid input cancelled
Vsak objekt `CompletableFuture` je zaključen že pred klicem `join()`. Primer prikaže vrednost `42`, sporočilo o vzroku neuspeha in neposredno sproženo izjemo `CancellationException`; blokiranja ne prikaže.
Povezane lekcije
- Java · Lekcija 51 · Srednja · Različica: 2