CKTIS / Java
CompletionException — wyjątek opakowujący niepowodzenie zadania
CompletionException to niekontrolowany wyjątek sygnalizujący błąd podczas kończenia zadania lub wyniku. Przy pracy z CompletableFuture pozwala przekazać przyczynę niepowodzenia do kodu odbierającego wynik przez join().
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
new CompletionException(Throwable cause)
new CompletionException(String message, Throwable cause)CompletionException z pakietu java.util.concurrent dziedziczy po RuntimeException, więc jest wyjątkiem niekontrolowanym. Sygnalizuje wyjątek lub błąd napotkany podczas kończenia zadania albo wyniku. Właściwą przyczynę można odczytać przez odziedziczoną metodę getCause(); może ona być null.
Publiczne konstruktory to CompletionException(Throwable cause) i CompletionException(String message, Throwable cause). Pierwszy wyznacza komunikat jako (cause == null ? null : cause.toString()). Konstruktory bez argumentów oraz przyjmujący wyłącznie String mają dostęp protected.
W CompletableFuture metoda join() zgłasza CompletionException przy niepowodzeniu; get() używa kontrolowanego ExecutionException. Anulowanie ma osobną ścieżkę: join() może zgłosić bezpośrednio CancellationException. Nie zakładaj więc, że każde niepowodzenie zostanie opakowane identycznie.
Przykład najpierw kończy future niepowodzeniem, a następnie wywołuje join(). Pokazuje osobno opakowanie i jego przyczynę, bez uruchamiania dodatkowych wątków. Przy diagnozowaniu zachowuj przyczynę zamiast ograniczać się do komunikatu opakowania.
Przykłady
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());
}
}
}
Wynik
CompletionException IllegalArgumentException: invalid input
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.