База знанияИзпитен център
BGБългарски
Избери език13

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

Източници