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

CKTIS / Java

Извличане на потиснати изключения с getSuppressed()

Използвай `getSuppressed()`, за да прочетеш вторичните изключения, записани към основното, например когато и блокът `try`, и автоматичното затваряне на ресурс завършат с изключение.

Версия: Java SE 21

Синтаксис

public final Throwable[] getSuppressed()

// Call on a Throwable instance:
Throwable[] suppressed = failure.getSuppressed();

Throwable.getSuppressed() е метод на екземпляр от класа java.lang.Throwable, който не приема аргументи и е наличен от Java 7. Извикай го върху прихванатото изключение, за да получиш масив Throwable[] с потиснатите изключения, записани непосредствено към този обект.

Конструкцията try-with-resources затваря ресурса автоматично. Ако блокът try и close() хвърлят изключения, които са различни обекти, изключението от блока остава основно. Изключението при затварянето се записва към него като потиснато, ако потискането е включено. Ако и двете хвърлят един и същ екземпляр на Throwable, генерираното извикване на addSuppressed() се опитва да добави изключението към собствения му списък с потиснати изключения и вместо това хвърля IllegalArgumentException. Ако блокът завърши нормално и само close() хвърли изключение, изключението при затварянето е основното.

Ако няма записани потиснати изключения или потискането е изключено за този обект, методът връща празен масив, никога null. Методът може да се извиква безопасно от няколко нишки. Замяната на елементи във върнатия масив не променя резултатите от следващите извиквания.

Не бъркай този резултат с резултата от getCause(), който връща причината или null, ако тя липсва или е неизвестна. Едно изключение може да има както причина, така и потиснати изключения.

Примери

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());
            }
        }
    }
}

Резултат

Primary: work failed
Suppressed: close failed

Блокът `catch` прихваща `work failed`. Цикълът прочита едно потиснато изключение, `close failed`, затова програмата отпечатва и двете съобщения.

Свързани уроци

  • Java · Урок 52 · Начално · Версия: 2

Източници