CKTIS / Java
CompletionException — incapsulare il fallimento di un’attività
CompletionException è un’eccezione non controllata che segnala un errore durante il completamento di un’attività o di un risultato. Con CompletableFuture, trasmette l’errore sottostante al codice che recupera il risultato tramite join().
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
new CompletionException(Throwable cause)
new CompletionException(String message, Throwable cause)CompletionException, nel package java.util.concurrent, estende RuntimeException ed è quindi un’eccezione non controllata. Segnala un’eccezione o un errore incontrato durante il completamento di un’attività o di un risultato. La causa sottostante è disponibile tramite il metodo ereditato getCause(); può essere null.
I costruttori pubblici sono CompletionException(Throwable cause) e CompletionException(String message, Throwable cause). Il primo ricava il messaggio come (cause == null ? null : cause.toString()). Il costruttore senza argomenti e quello che accetta solo String hanno accesso protected.
Con CompletableFuture, join() segnala l’errore usando CompletionException; get() usa l’eccezione controllata ExecutionException. La cancellazione segue un percorso distinto: join() può lanciare direttamente CancellationException. Non dare quindi per scontato che ogni errore venga incapsulato allo stesso modo.
L’esempio completa future in modo eccezionale prima di chiamare join(). Mostra separatamente l’eccezione che incapsula l’errore e la sua causa, senza avviare thread aggiuntivi. Quando analizzi gli errori, conserva la causa invece di mantenere solo il messaggio dell’eccezione che la incapsula.
Esempi
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.CompletionException;
public class Main {
public static void main(String[] args) {
CompletableFuture<String> future = new CompletableFuture<>();
future.completeExceptionally(new IllegalArgumentException("invalid input"));
try {
future.join();
} catch (CompletionException ex) {
Throwable cause = ex.getCause();
System.out.println(ex.getClass().getSimpleName());
System.out.println(cause.getClass().getSimpleName() + ": " + cause.getMessage());
}
}
}
Risultato
CompletionException IllegalArgumentException: invalid input
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.