CKTIS / Java
Leggere le eccezioni soppresse con getSuppressed()
Usa `getSuppressed()` per leggere le eccezioni secondarie registrate su un’eccezione principale, ad esempio quando falliscono sia il blocco `try` sia la chiusura automatica della risorsa.
Versione: Java SE 21
Sintassi
public final Throwable[] getSuppressed()
// Call on a Throwable instance:
Throwable[] suppressed = failure.getSuppressed();Throwable.getSuppressed() è un metodo di istanza senza argomenti di java.lang.Throwable, disponibile da Java 7. Chiamalo sull’eccezione intercettata per ottenere un array Throwable[] con le eccezioni soppresse registrate direttamente su quell’oggetto.
Un’istruzione try-with-resources chiude automaticamente la risorsa. Se il blocco try e close() lanciano due oggetti eccezione distinti, l’eccezione del blocco resta quella principale. L’eccezione di chiusura viene registrata su quella principale come soppressa, se la soppressione è abilitata. Se entrambi lanciano la stessa istanza di Throwable, la chiamata generata a addSuppressed() tenta di aggiungere l’eccezione al proprio elenco di eccezioni soppresse e lancia invece una IllegalArgumentException. Se il blocco termina normalmente e solo close() lancia un’eccezione, quella di chiusura è l’eccezione principale.
Se non sono state registrate eccezioni soppresse o la soppressione è disabilitata per quell’oggetto, il metodo restituisce un array vuoto, mai null. Il metodo è thread-safe: sostituire gli elementi nell’array restituito non cambia i risultati delle chiamate successive.
Non confondere questo risultato con quello di getCause(), che restituisce la causa oppure null se è assente o sconosciuta. Un’eccezione può avere sia una causa sia eccezioni soppresse.
Esempi
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());
}
}
}
}Risultato
Primary: work failed Suppressed: close failed
Il blocco `catch` intercetta `work failed`. Il ciclo legge una sola eccezione soppressa, `close failed`, quindi il programma stampa entrambi i messaggi.
Lezioni correlate
- Java · Lezione 52 · Base · Versione: 2