Класс 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
- См. также:
Краткое описание конструкторов
| Модификатор | Конструктор | Описание |
|---|---|---|
| Создает новую ошибку, используя 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 |
fillInStackTrace() |
Заполняет трассировку стека выполнения. |
Throwable |
getCause() |
Возвращает причину этого объекта Throwable или null, если причина отсутствует или неизвестна. |
String |
getLocalizedMessage() |
Создает локализованное описание этого объекта Throwable. |
String |
getMessage() |
Возвращает строку подробного сообщения этого объекта Throwable. |
StackTraceElement[] |
getStackTrace() |
Предоставляет программный доступ к информации о трассировке стека, выводимой методом Throwable.printStackTrace(). |
final Throwable[] |
getSuppressed() |
Возвращает массив, содержащий все исключения, которые были подавлены, обычно оператором try-with-resources, при передаче этого исключения. |
Throwable |
initCause |
Инициализирует причину этого объекта Throwable указанным значением. |
void |
printStackTrace() |
Выводит этот объект Throwable и его трассировку в стандартный поток ошибок. |
void |
printStackTrace |
Выводит этот объект Throwable и его трассировку в указанный поток печати. |
void |
printStackTrace |
Выводит этот объект Throwable и его трассировку в указанный модуль записи. |
void |
setStackTrace |
Задает элементы трассировки стека, которые будут возвращены методом Throwable.getStackTrace() и выведены методами Throwable.printStackTrace() и связанными с ним методами. |
String |
toString() |
Возвращает краткое описание этого объекта Throwable. |
Методы, объявленные в классе Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait | Модификатор и тип | Метод | Описание |
|---|---|---|
protected Object |
clone() |
Создает и возвращает копию этого объекта. |
boolean |
equals |
Указывает, равен ли другой объект этому объекту. |
protected void |
finalize() |
Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и может быть удалена в одном из будущих выпусков. |
final Class |
getClass() |
Возвращает класс времени выполнения этого Object. |
int |
hashCode() |
Возвращает значение хеш-кода для этого объекта. |
final void |
notify() |
Пробуждает один поток, ожидающий на мониторе этого объекта. |
final void |
notifyAll() |
Пробуждает все потоки, ожидающие на мониторе этого объекта. |
final void |
wait() |
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt. |
final void |
wait |
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения определенного промежутка реального времени. |
final void |
wait |
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова 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
© 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.