KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

CompletionException — een taakfout verpakken

CompletionException is een unchecked exception die een fout signaleert bij het voltooien van een taak of resultaat. Met CompletableFuture geeft deze de onderliggende fout door aan code die het resultaat met join() ophaalt.

Versie: Java SE 21; repository runtime, production runtime not attested

Syntax

new CompletionException(Throwable cause)
new CompletionException(String message, Throwable cause)

CompletionException in java.util.concurrent erft van RuntimeException en is daardoor een unchecked exception. Deze signaleert een exception of fout die is opgetreden bij het voltooien van een taak of resultaat. De onderliggende oorzaak is beschikbaar via de overgeërfde methode getCause(); deze kan null zijn.

De publieke constructors zijn CompletionException(Throwable cause) en CompletionException(String message, Throwable cause). De eerste leidt het bericht af als (cause == null ? null : cause.toString()). De constructor zonder argumenten en de constructor die alleen String accepteert, hebben toegang protected.

Bij CompletableFuture meldt join() een fout met CompletionException; get() gebruikt de checked exception ExecutionException. Annulering volgt een apart pad: join() kan rechtstreeks CancellationException gooien. Ga er dus niet van uit dat elke fout op dezelfde manier wordt verpakt.

Het voorbeeld voltooit future eerst uitzonderlijk en roept daarna join() aan. Het toont de verpakkende exception en de oorzaak afzonderlijk, zonder extra threads te starten. Bewaar bij het onderzoeken van fouten de oorzaak in plaats van alleen het bericht van de verpakkende exception.

Voorbeelden

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());
        }
    }
}

Resultaat

CompletionException
IllegalArgumentException: invalid input

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen