Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

CompletionException — envelopper l’échec d’une tâche

CompletionException est une exception non vérifiée qui signale un échec lors de l’achèvement d’une tâche ou d’un résultat. Avec CompletableFuture, elle transmet l’échec sous-jacent au code qui récupère le résultat avec join().

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

Syntaxe

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

CompletionException, dans java.util.concurrent, hérite de RuntimeException et constitue donc une exception non vérifiée. Elle signale une exception ou une erreur rencontrée lors de l’achèvement d’une tâche ou d’un résultat. La cause sous-jacente est accessible avec la méthode héritée getCause() ; elle peut être null.

Les constructeurs publics sont CompletionException(Throwable cause) et CompletionException(String message, Throwable cause). Le premier déduit son message ainsi : (cause == null ? null : cause.toString()). Le constructeur sans argument et celui qui prend uniquement un String ont un accès protected.

Avec CompletableFuture, join() signale un échec au moyen de CompletionException ; get() utilise l’exception vérifiée ExecutionException. L’annulation suit un chemin distinct : join() peut lancer directement CancellationException. Ne supposez donc pas que tous les échecs sont enveloppés de la même façon.

L’exemple termine future de façon exceptionnelle avant d’appeler join(). Il affiche séparément l’exception enveloppante et sa cause, sans démarrer de threads supplémentaires. Lors du diagnostic, conservez la cause au lieu de ne garder que le message de l’exception enveloppante.

Exemples

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

Résultat

CompletionException
IllegalArgumentException: invalid input

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources