Spec-Zone.ru › OpenJDK 27

Класс Error

java.lang.Object
java.lang.Throwable
java.lang.Error
Все реализуемые интерфейсы:
Serializable
Прямые известные подклассы:
AnnotationFormatError, AssertionError, AWTError, CoderMalfunctionError, FactoryConfigurationError, FactoryConfigurationError, IOError, LinkageError, SchemaFactoryConfigurationError, ServiceConfigurationError, ThreadDeath, TransformerFactoryConfigurationError, VirtualMachineError
public class Error extends Throwable
Error является подклассом Throwable, указывающим на серьезные проблемы, которые разумное приложение не должно пытаться перехватывать. Большинство таких ошибок представляют собой аномальные условия.

Метод не обязан объявлять в своей секции throws какие-либо подклассы Error, которые могут быть выброшены во время выполнения метода, но не перехвачены, поскольку эти ошибки представляют собой аномальные условия, которые никогда не должны возникать. Иными словами, Error и его подклассы считаются непроверяемыми исключениями при проверке исключений во время компиляции.

См. Спецификацию языка Java:
11.2 Проверка исключений во время компиляции
С версии:
1.0
См. также:
  • Сериализованная форма

Краткое описание конструкторов

Error()
Error(String message)
Error(String message, Throwable cause)
Error(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace)
Error(Throwable cause)
Модификатор Конструктор Описание
Создает новую ошибку, используя null в качестве подробного сообщения.
Создает новую ошибку с указанным подробным сообщением.
Создает новую ошибку с указанным подробным сообщением и причиной.
protected
Создает новую ошибку с указанным подробным сообщением и причиной, с включенным или отключенным подавлением и с включенной или отключенной возможностью записи трассировки стека.
Создает новую ошибку с указанной причиной и подробным сообщением (cause==null ? null : cause.toString()) (которое обычно содержит класс и подробное сообщение объекта cause).

Краткое описание методов

Методы, объявленные в классе Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
Модификатор и тип Метод Описание
final void addSuppressed(Throwable exception)
Добавляет указанное исключение к исключениям, подавленным при передаче этого исключения.
Throwable fillInStackTrace()
Заполняет трассировку стека выполнения.
Throwable getCause()
Возвращает причину этого объекта Throwable или null, если причина отсутствует или неизвестна.
String getLocalizedMessage()
Создает локализованное описание этого объекта Throwable.
String getMessage()
Возвращает строку подробного сообщения этого объекта Throwable.
StackTraceElement[] getStackTrace()
Предоставляет программный доступ к информации о трассировке стека, выводимой методом Throwable.printStackTrace().
final Throwable[] getSuppressed()
Возвращает массив, содержащий все исключения, которые были подавлены, обычно оператором try-with-resources, при передаче этого исключения.
Throwable initCause(Throwable cause)
Инициализирует причину этого объекта Throwable указанным значением.
void printStackTrace()
Выводит этот объект Throwable и его трассировку в стандартный поток ошибок.
void printStackTrace(PrintStream s)
Выводит этот объект Throwable и его трассировку в указанный поток печати.
void printStackTrace(PrintWriter s)
Выводит этот объект Throwable и его трассировку в указанный модуль записи.
void setStackTrace(StackTraceElement[] stackTrace)
Задает элементы трассировки стека, которые будут возвращены методом Throwable.getStackTrace() и выведены методами Throwable.printStackTrace() и связанными с ним методами.
String toString()
Возвращает краткое описание этого объекта Throwable.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Модификатор и тип Метод Описание
protected Object clone()
Создает и возвращает копию этого объекта.
boolean equals(Object obj)
Указывает, равен ли другой объект этому объекту.
protected void finalize()
Устарело, будет удалено: этот элемент API может быть удален в будущей версии.
Финализация объявлена устаревшей и может быть удалена в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
int hashCode()
Возвращает значение хеш-кода для этого объекта.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
final void wait()
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения определенного промежутка реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения определенного промежутка реального времени.

Подробное описание конструкторов

Error

public Error()
Создает новую ошибку, используя null в качестве подробного сообщения. Причина не инициализируется и впоследствии может быть инициализирована вызовом Throwable.initCause(Throwable).

Error

public Error(String message)
Создает новую ошибку с указанным подробным сообщением. Причина не инициализируется и впоследствии может быть инициализирована вызовом Throwable.initCause(Throwable).
Параметры:
message — подробное сообщение. Подробное сообщение сохраняется для последующего получения методом Throwable.getMessage().

Error

public Error(String message, Throwable cause)
Создает новую ошибку с указанным подробным сообщением и причиной.

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

Параметры:
message — подробное сообщение (сохраняется для последующего получения методом Throwable.getMessage()).
cause — причина (сохраняется для последующего получения методом Throwable.getCause()). Допускается значение null, указывающее, что причина отсутствует или неизвестна.
С версии:
1.4

Error

public Error(Throwable cause)
Создает новую ошибку с указанной причиной и подробным сообщением (cause==null ? null : cause.toString()) (которое обычно содержит класс и подробное сообщение объекта cause). Этот конструктор полезен для ошибок, которые представляют собой лишь оболочки для других объектов Throwable.
Параметры:
cause — причина (сохраняется для последующего получения методом Throwable.getCause()). Допускается значение null, указывающее, что причина отсутствует или неизвестна.
С версии:
1.4

Error

protected Error(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace)
Создает новую ошибку с указанным подробным сообщением и причиной, с включенным или отключенным подавлением и с включенной или отключенной возможностью записи трассировки стека.
Параметры:
message — подробное сообщение.
cause — причина. Допускается значение null, указывающее, что причина отсутствует или неизвестна.
enableSuppression — включено или отключено подавление
writableStackTrace — доступна ли запись трассировки стека
С версии:
1.7

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и работающие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2026, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API