Класс IllegalArgumentException

java.lang.IllegalArgumentException

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

Прямые известные подклассы:: ConstantPoolException, IllegalChannelGroupException, IllegalCharsetNameException, IllegalFormatException, IllegalSelectorException, IllegalThreadStateException, InvalidKeyException, InvalidOpenTypeException, InvalidParameterException, InvalidPathException, InvalidStreamException, KeyAlreadyExistsException, NumberFormatException, PatternSyntaxException, ProviderMismatchException, UnresolvedAddressException, UnsupportedAddressTypeException, UnsupportedCharsetException

public class IllegalArgumentException extends RuntimeException

Выбрасывается, чтобы указать, что методу был передан недопустимый или неподходящий аргумент.

С версии:

1.0

См. также:

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

Конструктор	Описание
`IllegalArgumentException()`	Создает `IllegalArgumentException` без подробного сообщения.
`IllegalArgumentException(String s)`	Создает `IllegalArgumentException` с указанным подробным сообщением.
`IllegalArgumentException(String message, Throwable cause)`	Создает новое исключение с указанным подробным сообщением и причиной.
`IllegalArgumentException(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 и его трассировку в указанный объект записи.
`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, либо до истечения заданного промежутка реального времени.

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

IllegalArgumentException

public IllegalArgumentException()

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

IllegalArgumentException

public IllegalArgumentException(String s)

Создает IllegalArgumentException с указанным подробным сообщением.

Параметры:: s — подробное сообщение.

IllegalArgumentException

public IllegalArgumentException(String message, Throwable cause)

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

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

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

IllegalArgumentException

public IllegalArgumentException(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.