Класс IllegalStateException

java.lang.IllegalStateException

Все реализуемые интерфейсы:: Serializable

public class IllegalStateException extends RuntimeException

Сигнализирует о том, что метод был вызван в недопустимый или неподходящий момент. Иными словами, среда Java или приложение Java находятся в неподходящем состоянии для запрошенной операции.

Начиная с:

1.1

См. также:

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

Конструктор	Описание
`IllegalStateException()`	Создает IllegalStateException без подробного сообщения.
`IllegalStateException(String s)`	Создает IllegalStateException с указанным подробным сообщением.
`IllegalStateException(String message, Throwable cause)`	Создает новое исключение с указанным подробным сообщением и причиной.
`IllegalStateException(Throwable cause)`	Создает новое исключение с указанной причиной и подробным сообщением `(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 и его трассировку в указанный объект print writer.
`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 или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или прерывания, либо истечения определенного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или прерывания, либо истечения определенного промежутка реального времени.

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

IllegalStateException

public IllegalStateException()

Создает IllegalStateException без подробного сообщения. Подробное сообщение — это строка, описывающая данное конкретное исключение.

IllegalStateException

public IllegalStateException(String s)

Создает IllegalStateException с указанным подробным сообщением. Подробное сообщение — это строка, описывающая данное конкретное исключение.

Параметры:: s — строка, содержащая подробное сообщение

IllegalStateException

public IllegalStateException(String message, Throwable cause)

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

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

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

IllegalStateException

public IllegalStateException(Throwable cause)

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

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

© 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.