Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

Viri