CKTIS / Java
CompletableFuture.get(): attendere un risultato
Usa `get()` per ottenere il risultato o `get(timeout, unit)` per limitare l’attesa. A differenza di `join()`, entrambe le forme dichiarano eccezioni controllate.
Versione: Java SE 21
Sintassi
public T get() throws InterruptedException, ExecutionException
public T get(long timeout, java.util.concurrent.TimeUnit unit) throws InterruptedException, ExecutionException, java.util.concurrent.TimeoutExceptionIn Java SE 21, CompletableFuture.get è un metodo di istanza di java.util.concurrent.CompletableFuture<T>. Una chiamata a get() blocca il thread chiamante solo se deve attendere il completamento. Se il future è già completato, non c’è attesa; in caso di successo il metodo restituisce il risultato di tipo T.
Entrambi gli overload lanciano InterruptedException se il thread chiamante viene interrotto durante l’attesa, oppure ExecutionException se il calcolo fallisce. Usa getCause() per esaminare la causa dell’errore. Se viene annullato il future stesso, viene lanciata l’eccezione non controllata CancellationException. Le eccezioni controllate vanno catturate o dichiarate con throws.
get(long timeout, TimeUnit unit) limita l’attesa, per esempio con future.get(2, TimeUnit.SECONDS). Se il tempo scade prima del completamento, la chiamata lancia l’eccezione controllata TimeoutException; la scadenza non annulla né completa il future.
Anche join() può bloccare e lancia CancellationException in caso di annullamento, ma non dichiara eccezioni controllate: un errore di calcolo viene segnalato con l’eccezione non controllata CompletionException. Per elaborare il risultato senza bloccare nel punto della chiamata, aggiungi uno stadio successivo, ad esempio con thenApply.
Esempi
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.CompletionException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;
public class Main {
public static void main(String[] args) throws InterruptedException, ExecutionException {
CompletableFuture<Integer> pending = new CompletableFuture<>();
try {
pending.get(0, TimeUnit.MILLISECONDS);
throw new AssertionError("Expected a timeout");
} catch (TimeoutException e) {
System.out.println("Timed out");
}
pending.complete(42);
System.out.println("Result: " + pending.get());
CompletableFuture<Integer> failed =
CompletableFuture.failedFuture(new IllegalStateException("No result"));
try {
failed.get();
} catch (ExecutionException e) {
System.out.println("get cause: " + e.getCause().getMessage());
}
try {
failed.join();
} catch (CompletionException e) {
System.out.println("join cause: " + e.getCause().getMessage());
}
}
}Risultato
Timed out Result: 42 get cause: No result join cause: No result
Il timeout zero provoca `TimeoutException` perché `pending` non è ancora completato. Dopo `complete(42)`, `get()` restituisce `42` senza aspettare. Infine, `get()` e `join()` mostrano la stessa causa dell’errore racchiusa in due eccezioni diverse.
Lezioni correlate
- Java · Lezione 51 · Intermedio · Versione: 2