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

CKTIS / Java

ExecutionException — fallo de una tarea al recuperar un resultado

ExecutionException es una excepción comprobada que se produce al recuperar el resultado de una tarea que terminó con una excepción. Distingue el fallo de la tarea del código que recibe el resultado; getCause() permite inspeccionar la causa subyacente.

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

Sintaxis

try { task.get(); } catch (ExecutionException e) { Throwable cause = e.getCause(); }

ExecutionException, del paquete java.util.concurrent, extiende Exception y es una excepción comprobada: debe capturarse o declararse en throws. Al recuperar un resultado mediante Future.get(), indica que el cálculo terminó con una excepción en lugar de producir un resultado satisfactorio.

Llame a getCause() para inspeccionar la causa; no intente identificarla analizando el texto de getMessage(). Los constructores públicos son ExecutionException(Throwable cause) y ExecutionException(String message, Throwable cause). Una instancia creada manualmente puede tener una causa null, por lo que el código de propósito general debe tenerlo en cuenta.

Distinga el fallo de la tarea de otros resultados de Future.get(): InterruptedException significa que el hilo que llama fue interrumpido mientras esperaba, mientras que CancellationException significa que se canceló la tarea. La sobrecarga con límite de tiempo también puede lanzar TimeoutException; que venza ese límite, por sí solo, no significa que la tarea haya fallado o se haya cancelado.

En el ejemplo, FutureTask.run() ejecuta la tarea en el hilo actual y registra su fallo. Solo task.get() lanza ExecutionException, cuya causa es IllegalArgumentException. No hacen falta otro hilo ni esperas adicionales. El ejemplo muestra el tipo y el mensaje de la causa; en código de producción, conserve la cadena de causas al propagar el fallo.

Ejemplos

import java.util.concurrent.ExecutionException;
import java.util.concurrent.FutureTask;

public class Main {
    public static void main(String[] args) throws InterruptedException {
        FutureTask<Integer> task = new FutureTask<>(() -> {
            throw new IllegalArgumentException("invalid input");
        });
        task.run();

        try {
            task.get();
        } catch (ExecutionException e) {
            Throwable cause = e.getCause();
            System.out.println(e.getClass().getSimpleName());
            System.out.println(cause.getClass().getSimpleName() + ": " + cause.getMessage());
        }
    }
}

Resultado

ExecutionException
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