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