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