CKTIS / Java
Throwable.getSuppressed() — потиснати изключения
Извикай `getSuppressed()` върху основното изключение, за да видиш добавените към него изключения, например грешка при затваряне на ресурс след грешка в блока `try`.
Версия: Java SE 21
Синтаксис
public final Throwable[] getSuppressed()getSuppressed() е метод на екземпляр на java.lang.Throwable, който не приема аргументи. Той връща масив Throwable[] с потиснатите изключения, добавени директно към обекта, върху който го извикваш. Ако няма добавени изключения или потискането е изключено за този обект, методът връща празен масив, а не null. Промените във върнатия масив не променят съхранения списък.
Ако блокът try хвърли изключение, а автоматичното извикване на close() хвърли друго, конструкцията try с ресурси предава нататък изключението от блока. Ако потискането е включено, тя добавя към него изключението от close(). Извикай getSuppressed() върху прихванатото основно изключение, а не върху изключението от close(): то не потиска само себе си.
Ако блокът завърши нормално и само едно затваряне хвърли изключение, това изключение се предава като основно. Ресурсите се затварят в ред, обратен на реда на инициализация. Ако след нормално завършване на блока няколко затваряния хвърлят различни изключения, основно е първото по реда на затваряне. Останалите се добавят към него, ако потискането е включено.
getCause() връща причината за изключението (или null), а не масив с допълнителни грешки. Един и същ обект може да има както причина, така и потиснати изключения.
Примери
public class Main {
public static void main(String[] args) {
try (AutoCloseable resource = () -> {
throw new IllegalStateException("close failed");
}) {
throw new IllegalStateException("body failed");
} catch (Exception primary) {
System.out.println("Primary: " + primary.getMessage());
Throwable[] suppressed = primary.getSuppressed();
System.out.println("Suppressed count: " + suppressed.length);
for (Throwable secondary : suppressed) {
System.out.println("Suppressed: " + secondary.getMessage());
System.out.println("Its suppressed count: " + secondary.getSuppressed().length);
}
}
}
}Резултат
Primary: body failed Suppressed count: 1 Suppressed: close failed Its suppressed count: 0
Първите три реда показват основното изключение и едно добавено изключение от `close()`. Последният ред показва, че в този пример изключението от `close()` няма собствени потиснати изключения.
Свързани уроци
- Java · Урок 31 · Средно · Версия: 2