CKTIS / Java
CompletableFuture.join(): dohvaćanje rezultata
`join()` dohvaća rezultat objekta `CompletableFuture` i po potrebi čeka njegov dovršetak. Ne deklarira provjeravane iznimke, ali može baciti neprovjeravanu iznimku.
Verzija: Java SE 21
Sintaksa
public T join()U Javi SE 21 CompletableFuture.join() je metoda instance klase java.util.concurrent.CompletableFuture<T> bez argumenata. Ako objekt još nije dovršen, poziv blokira trenutačnu dretvu do dovršetka. Pri normalnom dovršetku vraća rezultat tipa T; ako je rezultat već dostupan, ne čeka.
Ako izračun ne uspije, join() baca CompletionException, a uzrok možeš provjeriti metodom getCause(). Ako je otkazan sam objekt, join() izravno baca CancellationException. Obje su iznimke neprovjeravane: prevoditelj ne zahtijeva da ih uhvatiš ili deklariraš.
Za razliku od join(), get() baca provjeravanu iznimku InterruptedException ako se čekanje prekine, a neuspjeh izračuna prijavljuje provjeravanom iznimkom ExecutionException. join() ne završava čekanje bacanjem iznimke InterruptedException i ne prima vremensko ograničenje; za čekanje s ograničenjem upotrijebi get(timeout, unit). Thread.join() pak čeka da dretva završi, ne vraća rezultat izračuna (void) i deklarira InterruptedException.
Primjeri
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
Svaki je objekt `CompletableFuture` dovršen prije poziva metode `join()`. Primjer prikazuje vrijednost `42`, poruku uzroka neuspjeha i izravno bačenu iznimku `CancellationException`; ne prikazuje blokiranje.
Povezane lekcije
- Java · Lekcija 51 · Srednje · Verzija: 2