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

CKTIS / Java

Throwable.getCause(): recorrer la cadena de causas

`Throwable.getCause()` devuelve la causa inmediata. Llama al método en cada objeto sucesivo para recorrer la cadena desde la excepción externa hasta la última causa disponible.

Versión: Java SE 21

Sintaxis

public Throwable getCause()

Throwable cause = failure.getCause();

for (Throwable current = failure; current != null; current = current.getCause()) {
    // Process current.
}

Throwable.getCause() es un método de instancia sin argumentos de la clase java.lang.Throwable. Devuelve la causa inmediata como Throwable, o null si no hay causa o se desconoce. Al envolver una excepción en otra, pasa la excepción original a un constructor que acepte una causa para conservar el vínculo.

Empieza por la excepción externa. Mientras current != null, procesa el objeto actual y avanza con current = current.getCause(). La primera iteración incluye la propia excepción externa. El último objeto visitado no es necesariamente el origen real del problema: null solo indica que no hay otra causa disponible.

Las excepciones suprimidas se consultan por separado con getSuppressed(); el bucle que recorre las causas no las visita. Una cadena de causas puede contener un ciclo. Si tu código debe manejar cadenas arbitrarias, registra los objetos visitados por identidad de referencia, por ejemplo con IdentityHashMap, y detente cuando vuelvas a encontrar un objeto.

Ejemplos

public class CauseChainDemo {
    public static void main(String[] args) {
        Exception input = new Exception("Invalid port");
        Exception config = new Exception("Cannot load configuration", input);
        Exception startup = new Exception("Cannot start application", config);

        for (Throwable current = startup; current != null; current = current.getCause()) {
            System.out.println(current.getMessage());
        }
    }
}

Resultado

Cannot start application
Cannot load configuration
Invalid port

Los constructores enlazan tres objetos; el programa no los lanza. El bucle imprime los mensajes de `startup`, `config` e `input`, en ese orden. La causa de `input` es `null`, que detiene el bucle y no se imprime.

Lecciones relacionadas

  • Java · Lección 30 · Intermedio · Versión: 2

Fuentes