Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

CompletableFuture.join(): ottenere il risultato

`join()` restituisce il risultato di un `CompletableFuture`, attendendone il completamento se necessario. Non dichiara eccezioni controllate, ma può lanciare un’eccezione non controllata.

Versione: Java SE 21

Sintassi

public T join()

In Java SE 21, CompletableFuture.join() è un metodo di istanza senza argomenti di java.util.concurrent.CompletableFuture<T>. Se il future non è ancora completato, la chiamata blocca il thread corrente fino al completamento. In caso di completamento normale, restituisce il risultato di tipo T; se il risultato è già disponibile, non attende.

Se il calcolo fallisce, join() lancia CompletionException; puoi risalire alla causa con getCause(). Se è stato annullato il future stesso, join() lancia direttamente CancellationException. Entrambe sono eccezioni non controllate: il compilatore non richiede di intercettarle né di dichiararle.

A differenza di join(), get() lancia l’eccezione controllata InterruptedException se l’attesa viene interrotta e segnala un errore nel calcolo con l’eccezione controllata ExecutionException. join() non termina l’attesa lanciando InterruptedException e non accetta un limite di tempo; per limitare l’attesa, usa get(timeout, unit). Thread.join() attende invece la terminazione di un thread, non restituisce un risultato del calcolo (void) e dichiara InterruptedException.

Esempi

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");
        }
    }
}

Risultato

42
failure: invalid input
cancelled

Ogni future è già completato prima della chiamata a `join()`. L’esempio mostra il valore `42`, il messaggio della causa dell’errore e una `CancellationException` lanciata direttamente; non mostra il blocco.

Lezioni correlate

  • Java · Lezione 51 · Intermedio · Versione: 2

Fonti