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

CKTIS / Java

Throwable.getMessage(): прочитане на подробно съобщение за изключение

Прочети съобщението на конкретно изключение, обработи липсващия текст и разграничи основното изключение от причините му и потиснатите изключения.

Версия: Java SE 21

Синтаксис

public String getMessage()

Throwable.getMessage() е метод на екземпляр без параметри. Извикването e.getMessage() връща подробното съобщение на обекта e като String или връща null. null не е празният низ "". Провери резултата, преди да го използваш като низ. Ако самата референция e е null, извикването хвърля NullPointerException.

new NullPointerException("name").getMessage() връща "name". Ако не е подадено изрично съобщение, различно от null, резултатът може да зависи от реализацията или да е null. Java SE 21 не гарантира точния текст или че в него ще присъства име на променлива. Прихванатото изключение IllegalArgumentException наследява getMessage() и така може да върне текста, подаден на конструктора му.

getCause() връща обекта, който представлява причината, или null, ако причината липсва или е неизвестна. При верига без цикли проследи причините чрез getCause() до null, като извикваш getMessage() за всяка от тях. IllegalArgumentException(String, Throwable) не добавя съобщението на причината към подадения текст. Претовареният конструктор IllegalArgumentException(Throwable) извежда съобщението от cause.toString() или използва null, ако причината е null.

Ако тялото на конструкция try-with-resources и методът close() хвърлят различни изключения, основно остава изключението от тялото. При включено потискане изключението при затваряне попада в масива, върнат от getSuppressed(), а не във веригата от причини. Прочети съобщението на всеки елемент поотделно. Масивът е празен, ако няма потиснати изключения или потискането е изключено.

getMessage() не връща трасировка на стека и не добавя автоматично името на класа. По подразбиране getLocalizedMessage() връща същия резултат като getMessage(), но подклас може да предефинира метода. Използвай текста за диагностика, не като код за грешка: не определяй хода на програмата по него и не показвай на потребителите непроверени вътрешни съобщения.

Примери

public class Main {
    static final class Resource implements AutoCloseable {
        @Override
        public void close() {
            throw new IllegalStateException("close fail");
        }
    }

    public static void main(String[] args) {
        try (Resource resource = new Resource()) {
            throw new IllegalArgumentException("primary", new NullPointerException("name"));
        } catch (IllegalArgumentException e) {
            System.out.println("Caught: " + e.getMessage());
            for (Throwable cause = e.getCause(); cause != null; cause = cause.getCause()) {
                System.out.println("Cause: " + cause.getMessage());
            }
            for (Throwable suppressed : e.getSuppressed()) {
                System.out.println("Suppressed: " + suppressed.getMessage());
            }
        }

        String message = new IllegalArgumentException().getMessage();
        System.out.println("No message: " + (message == null ? "(absent)" : message));
    }
}

Резултат

Caught: primary
Cause: name
Suppressed: close fail
No message: (absent)

Изходът показва отделно съобщението на прихванатото изключение `IllegalArgumentException` (`primary`), съобщението на причината му (`name`) и съобщението на потиснатото изключение от `close()` (`close fail`). На последния ред програмата заменя `null` с `(absent)`.

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

  • Java · Урок 28 · Средно · Версия: 2
  • Java · Урок 29 · Средно · Версия: 2
  • Java · Урок 30 · Средно · Версия: 2
  • Java · Урок 31 · Средно · Версия: 2

Източници