CKTIS / Java
CompletionException – einen Aufgabenfehler verpacken
CompletionException ist eine unchecked Exception, die einen Fehler beim Abschließen einer Aufgabe oder eines Ergebnisses signalisiert. Bei CompletableFuture übermittelt sie den zugrunde liegenden Fehler an Code, der das Ergebnis mit join() abruft.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
new CompletionException(Throwable cause)
new CompletionException(String message, Throwable cause)CompletionException aus java.util.concurrent erbt von RuntimeException und ist daher eine unchecked Exception. Sie signalisiert eine Exception oder einen Fehler, der beim Abschließen einer Aufgabe oder eines Ergebnisses aufgetreten ist. Die zugrunde liegende Ursache ist über die geerbte Methode getCause() verfügbar; sie kann null sein.
Die öffentlichen Konstruktoren sind CompletionException(Throwable cause) und CompletionException(String message, Throwable cause). Der erste leitet seine Meldung als (cause == null ? null : cause.toString()) ab. Der parameterlose Konstruktor und der Konstruktor, der nur String entgegennimmt, haben den Zugriffsmodifizierer protected.
Bei CompletableFuture meldet join() einen Fehler mit CompletionException; get() verwendet die checked Exception ExecutionException. Für Abbrüche gibt es einen separaten Weg: join() kann direkt CancellationException auslösen. Gehen Sie also nicht davon aus, dass jeder Fehler auf dieselbe Weise verpackt wird.
Das Beispiel schließt future zunächst fehlerhaft ab und ruft danach join() auf. Es gibt die verpackte Exception und ihre Ursache getrennt aus, ohne zusätzliche Threads zu starten. Bewahren Sie bei der Fehlerdiagnose die Ursache auf, statt nur die Meldung der verpackenden Exception zu behalten.
Beispiele
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());
}
}
}
Ergebnis
CompletionException IllegalArgumentException: invalid input
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.