CKTIS / Java
Consultar las excepciones suprimidas con getSuppressed()
Usa `getSuppressed()` para consultar las excepciones secundarias registradas en una excepción principal, por ejemplo, si fallan tanto el bloque `try` como el cierre automático de un recurso.
Versión: Java SE 21
Sintaxis
public final Throwable[] getSuppressed()
// Call on a Throwable instance:
Throwable[] suppressed = failure.getSuppressed();Throwable.getSuppressed() es un método de instancia sin argumentos de java.lang.Throwable, disponible desde Java 7. Llámalo sobre la excepción capturada para obtener un array Throwable[] con las excepciones suprimidas registradas directamente en ese objeto.
Una sentencia try-with-resources cierra el recurso de forma automática. Si el bloque try y close() lanzan objetos de excepción distintos, la del bloque sigue siendo la principal y la del cierre se registra en ella como suprimida si la supresión está habilitada. Si ambos lanzan la misma instancia de Throwable, la llamada generada a addSuppressed() intenta añadir la excepción a su propia lista de excepciones suprimidas y lanza en su lugar una IllegalArgumentException. Si el bloque termina normalmente y solo close() lanza una excepción, la del cierre es la principal.
Si no se registraron excepciones suprimidas o la supresión está deshabilitada para ese objeto, el método devuelve un array vacío, nunca null. El método es seguro para el uso concurrente: cambiar los elementos del array devuelto no altera los resultados de llamadas posteriores.
No confundas este resultado con el de getCause(), que devuelve la causa o null si no existe o se desconoce. Una excepción puede tener tanto una causa como excepciones suprimidas.
Ejemplos
import java.io.IOException;
public class Main {
static class DemoResource implements AutoCloseable {
@Override
public void close() throws IOException {
throw new IOException("close failed");
}
}
public static void main(String[] args) {
try (DemoResource resource = new DemoResource()) {
throw new IOException("work failed");
} catch (IOException failure) {
System.out.println("Primary: " + failure.getMessage());
for (Throwable suppressed : failure.getSuppressed()) {
System.out.println("Suppressed: " + suppressed.getMessage());
}
}
}
}Resultado
Primary: work failed Suppressed: close failed
El bloque `catch` captura `work failed`. El bucle lee una única excepción suprimida, `close failed`, por lo que el programa imprime ambos mensajes.
Lecciones relacionadas
- Java · Lección 52 · Básico · Versión: 2