Класс AssertionError

java.lang.Object

java.lang.Throwable

java.lang.Error

java.lang.AssertionError

Все реализованные интерфейсы:: Serializable

public class AssertionError extends Error

Выбрасывается, чтобы указать на неудачную проверку утверждения.

Семь общедоступных конструкторов этого класса с одним аргументом гарантируют, что ошибка утверждения, возвращаемая вызовом:

    new AssertionError(expression)

будет иметь в качестве подробного сообщения строковое представление выражения (как определено в разделе Â§5.1.11 Спецификации языка Java) независимо от типа выражения.

Начиная с:

1.4

См. также:

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

Конструктор	Описание
`AssertionError()`	Создает AssertionError без подробного сообщения.
`AssertionError(boolean detailMessage)`	Создает AssertionError, подробное сообщение которого формируется на основе указанного `boolean`, преобразуемого в строку, как определено в разделе Â§5.1.11 Спецификации языка Java.
`AssertionError(char detailMessage)`	Создает AssertionError, подробное сообщение которого формируется на основе указанного `char`, преобразуемого в строку, как определено в разделе Â§5.1.11 Спецификации языка Java.
`AssertionError(double detailMessage)`	Создает AssertionError, подробное сообщение которого формируется на основе указанного `double`, преобразуемого в строку, как определено в разделе Â§5.1.11 Спецификации языка Java.
`AssertionError(float detailMessage)`	Создает AssertionError, подробное сообщение которого формируется на основе указанного `float`, преобразуемого в строку, как определено в разделе Â§5.1.11 Спецификации языка Java.
`AssertionError(int detailMessage)`	Создает AssertionError, подробное сообщение которого формируется на основе указанного `int`, преобразуемого в строку, как определено в разделе Â§5.1.11 Спецификации языка Java.
`AssertionError(long detailMessage)`	Создает AssertionError, подробное сообщение которого формируется на основе указанного `long`, преобразуемого в строку, как определено в разделе Â§5.1.11 Спецификации языка Java.
`AssertionError(Object detailMessage)`	Создает AssertionError, подробное сообщение которого формируется на основе указанного объекта, преобразуемого в строку, как определено в разделе Â§5.1.11 Спецификации языка Java.
`AssertionError(String message, Throwable cause)`	Создает новый `AssertionError` с указанным подробным сообщением и причиной.

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

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

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

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

Методы, объявленные в классе 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()`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо истечения заданного промежутка реального времени.

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

AssertionError

public AssertionError()

Создает AssertionError без подробного сообщения.

AssertionError

public AssertionError(Object detailMessage)

Создает AssertionError, подробное сообщение которого формируется на основе указанного объекта, преобразуемого в строку, как определено в разделе Â§5.1.11 Спецификации языка Java.

Если указанный объект является экземпляром Throwable, он становится причиной вновь созданной ошибки утверждения.

Параметры:

detailMessage — значение, используемое при формировании подробного сообщения

См. также:

AssertionError

public AssertionError(boolean detailMessage)

Создает AssertionError, подробное сообщение которого формируется на основе указанного boolean, преобразуемого в строку, как определено в разделе Â§5.1.11 Спецификации языка Java.

Параметры:: detailMessage — значение, используемое при формировании подробного сообщения

AssertionError

public AssertionError(char detailMessage)

Создает AssertionError, подробное сообщение которого формируется на основе указанного char, преобразуемого в строку, как определено в разделе Â§5.1.11 Спецификации языка Java.

Параметры:: detailMessage — значение, используемое при формировании подробного сообщения

AssertionError

public AssertionError(int detailMessage)

Создает AssertionError, подробное сообщение которого формируется на основе указанного int, преобразуемого в строку, как определено в разделе Â§5.1.11 Спецификации языка Java.

Параметры:: detailMessage — значение, используемое при формировании подробного сообщения

AssertionError

public AssertionError(long detailMessage)

Создает AssertionError, подробное сообщение которого формируется на основе указанного long, преобразуемого в строку, как определено в разделе Â§5.1.11 Спецификации языка Java.

Параметры:: detailMessage — значение, используемое при формировании подробного сообщения

AssertionError

public AssertionError(float detailMessage)

Создает AssertionError, подробное сообщение которого формируется на основе указанного float, преобразуемого в строку, как определено в разделе Â§5.1.11 Спецификации языка Java.

Параметры:: detailMessage — значение, используемое при формировании подробного сообщения

AssertionError

public AssertionError(double detailMessage)

Создает AssertionError, подробное сообщение которого формируется на основе указанного double, преобразуемого в строку, как определено в разделе Â§5.1.11 Спецификации языка Java.

Параметры:: detailMessage — значение, используемое при формировании подробного сообщения

AssertionError

public AssertionError(String message, Throwable cause)

Создает новый AssertionError с указанным подробным сообщением и причиной.

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

Параметры:: message — подробное сообщение, может быть null; cause — причина, может быть null
Начиная с:: 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.