Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

Izvori