Класс Throwable

public Throwable()

Создаёт новый объект исключения с null в качестве сообщения об ошибке. Причина не инициализирована и может быть инициализирована позже вызовом initCause(java.lang.Throwable).

Метод fillInStackTrace() вызывается для инициализации данных стека вызовов в созданном объекте исключения.

public Throwable(String message)

Создаёт новый объект исключения со заданным сообщением об ошибке. Причина не инициализирована и может быть инициализирована позже вызовом initCause(java.lang.Throwable).

Метод fillInStackTrace() вызывается для инициализации данных стека вызовов в созданном объекте исключения.

public Throwable(String message,
                 Throwable cause)

Создаёт новый объект исключения со заданным сообщением об ошибке и причиной.

Обратите внимание, что сообщение об ошибке, связанное с cause, не автоматически включается в сообщение об ошибке этого объекта исключения.

Метод fillInStackTrace() вызывается для инициализации данных стека вызовов в созданном объекте исключения.

public Throwable(Throwable cause)

Создаёт новый объект исключения со заданной причиной и сообщением об ошибке (cause==null ? null : cause.toString()) (обычно содержащим класс и сообщение об ошибке cause). Этот конструктор полезен для объектов исключений, которые являются в основном обёртками для других объектов исключений (например, PrivilegedActionException).

Метод fillInStackTrace() вызывается для инициализации данных стека вызовов в созданном объекте исключения.

protected Throwable(String message,
                    Throwable cause,
                    boolean enableSuppression,
                    boolean writableStackTrace)

Создаёт новый объект исключения со заданным сообщением об ошибке, причиной, включением или выключением подавления исключений, и включением или выключением записи стека вызовов. Если подавление исключений отключено, getSuppressed() для этого объекта вернёт массив нулевой длины, и вызовы addSuppressed(java.lang.Throwable), которые в противном случае добавили бы исключение в список подавленных исключений, не будут иметь никакого эффекта. Если запись стека вызовов отключена, этот конструктор не вызовет fillInStackTrace(), поле null будет записано в поле stackTrace, и последующие вызовы fillInStackTrace и setStackTrace(StackTraceElement[]) не установят стек вызовов. Если запись стека вызовов отключена, getStackTrace() вернёт массив нулевой длины.

Обратите внимание, что другие конструкторы Throwable обрабатывают подавление как включённое, а стек вызовов как доступный. Подклассы Throwable должны документировать любые условия, при которых подавление выключено, и документировать условия, при которых стек вызовов не доступен. Отключение подавления должно происходить только в исключительных случаях, когда существуют специальные требования, такие как повторное использование объектов исключений виртуальной машиной в ситуациях с низким объёмом памяти. Ситуации, когда объект исключения многократно перехватывается и повторно выбрасывается, например, для реализации потока управления между двумя подсистемами, являются ещё одним случаем, когда неизменяемые объекты исключений были бы уместны.

public String getMessage()

public String getLocalizedMessage()

public Throwable getCause()

Возвращает причину этого объекта исключения или null если причина отсутствует или неизвестна. (Причина — это исключение, которое вызвало данное исключение.)

Эта реализация возвращает причину, которая была предоставлена через один из конструкторов, требующих Throwable, или которая была установлена после создания с помощью метода initCause(Throwable). Хотя обычно переопределять этот метод необязательно, подкласс может переопределить его, чтобы вернуть причину, установленную каким-то другим способом. Это подходит для "унаследованного исключения" (chained throwable), существовавшего до добавления цепочек исключений в Throwable. Обратите внимание, что не требуется переопределять любые из методов PrintStackTrace, все из которых вызывают метод getCause для определения причины исключения.

public Throwable initCause(Throwable cause)

Инициализирует причину этого объекта исключения заданным значением. (Причина — это исключение, которое вызвало данное исключение.)

Этот метод может быть вызван не более одного раза. Обычно он вызывается из конструктора или сразу после создания объекта исключения. Если этот объект исключения был создан с помощью Throwable(Throwable) или Throwable(String,Throwable), этот метод не может быть вызван ни разу.

Пример использования этого метода для унаследованного типа исключения без другой поддержки для установки причины:

try {
     lowLevelOp();
 } catch (LowLevelException le) {
     throw (HighLevelException)
           new HighLevelException().initCause(le); // Legacy constructor
 }

public String toString()

public void printStackTrace()

Выводит данное исключение и его стек-трейс в стандартный поток ошибок. Этот метод выводит стек-трейс для данного объекта Throwable в поток вывода ошибок, который является значением поля System.err. Первая строка вывода содержит результат метода toString() для этого объекта. Остальные строки представляют данные, ранее записанные методом fillInStackTrace(). Формат этой информации зависит от реализации, но следующий пример может считаться типичным:

java.lang.NullPointerException
        at MyClass.mash(MyClass.java:9)
        at MyClass.crunch(MyClass.java:6)
        at MyClass.main(MyClass.java:3)

Этот пример был получен при выполнении программы:

class MyClass {
     public static void main(String[] args) {
         crunch(null);
     }
     static void crunch(int[] a) {
         mash(a);
     }
     static void mash(int[] b) {
         System.out.println(b[0]);
     }
 }

Стек-трейс для исключения с инициализированным, непустым причиной обычно должен включать стек-трейс для причины. Формат этой информации зависит от реализации, но следующий пример может считаться типичным:

HighLevelException: MidLevelException: LowLevelException
         at Junk.a(Junk.java:13)
         at Junk.main(Junk.java:4)
 Caused by: MidLevelException: LowLevelException
         at Junk.c(Junk.java:23)
         at Junk.b(Junk.java:17)
         at Junk.a(Junk.java:11)
         ... 1 more
 Caused by: LowLevelException
         at Junk.e(Junk.java:30)
         at Junk.d(Junk.java:27)
         at Junk.c(Junk.java:21)
         ... 3 more

Обратите внимание на наличие строк, содержащих символы "...". Эти строки указывают, что остальная часть стек-трейса для этого исключения соответствует указанному числу кадров с нижней части стек-трейса исключения, которое вызвало это исключение (исключение "внешней оболочки"). Этот сокращенный формат значительно сокращает длину вывода в распространённом случае, когда исключение обертки выбрасывается из того же метода, что и исключение "причины". Приведенный выше пример был получен при выполнении программы:

public class Junk {
     public static void main(String args[]) {
         try {
             a();
         } catch(HighLevelException e) {
             e.printStackTrace();
         }
     }
     static void a() throws HighLevelException {
         try {
             b();
         } catch(MidLevelException e) {
             throw new HighLevelException(e);
         }
     }
     static void b() throws MidLevelException {
         c();
     }
     static void c() throws MidLevelException {
         try {
             d();
         } catch(LowLevelException e) {
             throw new MidLevelException(e);
         }
     }
     static void d() throws LowLevelException {
        e();
     }
     static void e() throws LowLevelException {
         throw new LowLevelException();
     }
 }

 class HighLevelException extends Exception {
     HighLevelException(Throwable cause) { super(cause); }
 }

 class MidLevelException extends Exception {
     MidLevelException(Throwable cause)  { super(cause); }
 }

 class LowLevelException extends Exception {
 }

Начиная с версии 7, платформа поддерживает понятие подавляемых исключений (в сочетании с инструкцией try-with-resources). Любые исключения, которые были подавлены для передачи исключения, выводятся под стек-трейсом. Формат этой информации зависит от реализации, но следующий пример может считаться типичным:

Exception in thread "main" java.lang.Exception: Something happened
  at Foo.bar(Foo.java:10)
  at Foo.main(Foo.java:5)
  Suppressed: Resource$CloseFailException: Resource ID = 0
          at Resource.close(Resource.java:26)
          at Foo.bar(Foo.java:9)
          ... 1 more

Обратите внимание, что обозначение "... n больше" используется для подавленных исключений точно так же, как и для причин. В отличие от причин, подавленные исключения имеют отступ за пределами своих "содержащих исключений".

Исключение может иметь как причину, так и одно или несколько подавленных исключений:

Exception in thread "main" java.lang.Exception: Main block
  at Foo3.main(Foo3.java:7)
  Suppressed: Resource$CloseFailException: Resource ID = 2
          at Resource.close(Resource.java:26)
          at Foo3.main(Foo3.java:5)
  Suppressed: Resource$CloseFailException: Resource ID = 1
          at Resource.close(Resource.java:26)
          at Foo3.main(Foo3.java:5)
 Caused by: java.lang.Exception: I did it
  at Foo3.main(Foo3.java:8)

Аналогично, подавленное исключение может иметь причину:

Exception in thread "main" java.lang.Exception: Main block
  at Foo4.main(Foo4.java:6)
  Suppressed: Resource2$CloseFailException: Resource ID = 1
          at Resource2.close(Resource2.java:20)
          at Foo4.main(Foo4.java:5)
  Caused by: java.lang.Exception: Rats, you caught me
          at Resource2$CloseFailException.<init>(Resource2.java:45)
          ... 2 more

public void printStackTrace(PrintStream s)

public void printStackTrace(PrintWriter s)

public Throwable fillInStackTrace()

Заполняет стек-трейс выполнения. Этот метод записывает в этот объект Throwable информацию о текущем состоянии стековых кадров для текущей нити.

Если стек-трейс данного объекта Throwable не может быть записан, вызов этого метода не имеет эффекта.

public StackTraceElement[] getStackTrace()

Предоставляет программисту доступ к информации о стек-трейсе, выводимой методом printStackTrace(). Возвращает массив элементов стек-трейса, каждый из которых представляет один стековый кадр. Нулевой элемент массива (при условии, что длина массива не равна нулю) представляет вершину стека, то есть последний вызов метода в последовательности. Обычно это точка, в которой данное исключение было создано и выброшено. Последний элемент массива (при условии, что длина массива не равна нулю) представляет низ стека, то есть первый вызов метода в последовательности.

Некоторые виртуальные машины могут в некоторых обстоятельствах опустить один или несколько стековых кадров из стек-трейса. В крайнем случае, виртуальной машине, не имеющей информации о стек-трейсе данного исключения, разрешено возвращать массив нулевой длины из этого метода. В общем случае, массив, возвращаемый этим методом, будет содержать по одному элементу для каждого кадра, который был бы напечатан методом printStackTrace. Записи в возвращаемый массив не влияют на последующие вызовы этого метода.

public void setStackTrace(StackTraceElement[] stackTrace)

Устанавливает элементы стек-трейса, которые будут возвращены методом getStackTrace() и напечатаны методами printStackTrace() и связанными методами. Этот метод, предназначенный для использования фреймворками RPC и другими продвинутыми системами, позволяет клиенту переопределить стандартный стек-трейс, который генерируется методом fillInStackTrace() при создании исключения или десериализуется при чтении исключения из потока сериализации.

Если стек-трейс данного объекта Throwable не может быть записан, вызов этого метода не имеет эффекта, кроме валидации его аргумента.

public final void addSuppressed(Throwable exception)

Добавляет указанное исключение к исключениям, которые были подавлены для передачи этого исключения. Этот метод потокобезопасен и обычно вызывается (автоматически и неявно) инструкцией try-with-resources.

Поведение подавления включено если не отключено через конструктор. Когда подавление отключено, этот метод ничего не делает, кроме валидации своего аргумента.

Обратите внимание, что когда одно исключение вызывает другое исключение, первое исключение обычно перехватывается, а затем второе исключение выбрасывается в ответ. Другими словами, между двумя исключениями существует причинно-следственная связь. В противоположность этому, существуют ситуации, когда два независимых исключения могут быть выброшены в блоках кода-близнецах, особенно в блоке try инструкции try-with-resources и сгенерированном компилятором блоке finally, который закрывает ресурс. В этих ситуациях только одно из выброшенных исключений может быть распространено. В инструкции try-with-resources, когда существуют два таких исключения, исключение, исходящее из блока try, распространяется, а исключение из блока finally добавляется в список подавленных исключений исключения из блока try. По мере выхода исключения из стека оно может накапливать несколько подавленных исключений.

Исключение может иметь подавленные исключения и при этом вызываться другим исключением. Является ли исключение причиной известно на момент его создания, в отличие от вопроса, будет ли исключение подавлять другие исключения, что обычно определяется только после выброса исключения.

Обратите внимание, что программист также может использовать этот метод в ситуациях с несколькими исключениями-близнецами, когда только одно из них может быть распространено.

public final Throwable[] getSuppressed()