Класс Exception

java.lang.Object

java.lang.Throwable

java.lang.Exception

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

Прямые известные подклассы:: AbsentInformationException, AgentInitializationException, AgentLoadException, AlreadyBoundException, AttachNotSupportedException, AWTException, BackingStoreException, BadAttributeValueExpException, BadBinaryOpValueExpException, BadLocationException, BadStringOperationException, BrokenBarrierException, CardException, CertificateException, ClassNotLoadedException, CloneNotSupportedException, DataFormatException, DatatypeConfigurationException, DestroyFailedException, ExecutionControl.ExecutionControlException, ExecutionException, ExpandVetoException, FontFormatException, GeneralSecurityException, GSSException, IllegalClassFormatException, IllegalConnectorArgumentsException, IncompatibleThreadStateException, InterruptedException, IntrospectionException, InvalidApplicationException, InvalidMidiDataException, InvalidPreferencesFormatException, InvalidTargetObjectTypeException, InvalidTypeException, InvocationException, IOException, JMException, JShellException, KeySelectorException, LambdaConversionException, LineUnavailableException, MarshalException, MidiUnavailableException, MimeTypeParseException, NamingException, NoninvertibleTransformException, NotBoundException, ParseException, ParserConfigurationException, PrinterException, PrintException, PrivilegedActionException, PropertyVetoException, ReflectiveOperationException, RefreshFailedException, RuntimeException, SAXException, ScriptException, ServerNotActiveException, SQLException, StringConcatException, TimeoutException, TooManyListenersException, TransformerException, TransformException, UnmodifiableClassException, UnsupportedAudioFileException, UnsupportedCallbackException, UnsupportedFlavorException, UnsupportedLookAndFeelException, URIReferenceException, URISyntaxException, VMStartException, XAException, XMLSignatureException, XMLStreamException, XPathException

public class Exception extends Throwable

Класс Exception и его подклассы представляют собой разновидность Throwable, указывающую на ситуации, которые приложение может счесть нужным обработать.

Класс Exception и все его подклассы, не являющиеся также подклассами RuntimeException, относятся к проверяемым исключениям. Проверяемые исключения необходимо объявлять в предложении throws метода или конструктора, если они могут быть выброшены при выполнении метода или конструктора и выйти за его границы.

См. Спецификацию языка Java:

11.2 Проверка исключений во время компиляции

С версии:

1.0

См. также:

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

Exception()

Exception(String message)

Exception(String message,
 Throwable cause)

Exception(String message,
 Throwable cause,
 boolean enableSuppression,
 boolean writableStackTrace)

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

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

Exception

public Exception()

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

Exception

public Exception(String message)

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

Параметры:: message — подробное сообщение. Оно сохраняется для последующего получения методом Throwable.getMessage().

Exception

public Exception(String message, Throwable cause)

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

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

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

Exception

public Exception(Throwable cause)

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

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

Exception

protected Exception(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.