Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

CompletionException: envolver el fallo de una tarea

CompletionException es una excepción no comprobada que indica un fallo al completar una tarea o un resultado. Con CompletableFuture, transmite el fallo subyacente al código que obtiene el resultado mediante join().

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

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

CompletionException, del paquete java.util.concurrent, hereda de RuntimeException, por lo que es una excepción no comprobada. Indica una excepción o un error que se ha producido al completar una tarea o un resultado. La causa subyacente está disponible mediante el método heredado getCause(); puede ser null.

Los constructores públicos son CompletionException(Throwable cause) y CompletionException(String message, Throwable cause). El primero obtiene su mensaje como (cause == null ? null : cause.toString()). El constructor sin argumentos y el que recibe únicamente String tienen acceso protected.

En CompletableFuture, join() comunica los fallos mediante CompletionException; get() utiliza la excepción comprobada ExecutionException. La cancelación sigue una vía distinta: join() puede lanzar directamente CancellationException. Por tanto, no des por hecho que todos los fallos se envuelven de la misma manera.

El ejemplo completa future de forma excepcional antes de llamar a join(). Muestra por separado la excepción envolvente y su causa, sin iniciar hilos adicionales. Al diagnosticar fallos, conserva la causa en lugar de quedarte solo con el mensaje de la excepción envolvente.

Ejemplos

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

Resultado

CompletionException
IllegalArgumentException: invalid input

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes