Класс SAXException

org.xml.sax.SAXException

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

Прямые известные подклассы:: SAXNotRecognizedException, SAXNotSupportedException, SAXParseException

public class SAXException extends Exception

Инкапсулирует общую ошибку или предупреждение SAX.

Этот класс может содержать основные сведения об ошибке или предупреждении от XML-парсера или приложения: разработчик парсера или приложения может создать его подкласс, чтобы добавить дополнительные возможности. Обработчики SAX могут выбрасывать это исключение или любой его подкласс.

Если приложению необходимо передать исключения других типов, оно должно обернуть их в SAXException или исключение, производное от SAXException.

Если парсеру или приложению необходимо включить сведения о конкретном местоположении в XML-документе, следует использовать подкласс SAXParseException.

Начиная с версии:

1.4, SAX 1.0

См. также:

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

Конструктор	Описание
`SAXException()`	Создает новый SAXException.
`SAXException(Exception e)`	Создает новый SAXException, оборачивающий существующее исключение.
`SAXException(String message)`	Создает новый SAXException.
`SAXException(String message, Exception e)`	Создает новый SAXException на основе существующего исключения.

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

Модификатор и тип	Метод	Описание
`Throwable`	`getCause()`	Возвращает причину исключения
`Exception`	`getException()`	Возвращает вложенное исключение, если оно есть.
`String`	`getMessage()`	Возвращает подробное сообщение для этого исключения.
`String`	`toString()`	Переопределяет toString, чтобы учитывать любое вложенное исключение.

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

addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Модификатор и тип	Метод	Описание
`final void`	`addSuppressed(Throwable exception)`	Добавляет указанное исключение к исключениям, подавленным при передаче этого исключения.
`Throwable`	`fillInStackTrace()`	Заполняет трассировку стека выполнения.
`String`	`getLocalizedMessage()`	Создает локализованное описание этого объекта-исключения.
`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()` и связанными методами.

Методы, объявленные в классе 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, либо истечения заданного промежутка реального времени.

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

SAXException

public SAXException()

Создает новый SAXException.

SAXException

public SAXException(String message)

Создает новый SAXException.

Параметры:: message — Сообщение об ошибке или предупреждении.

SAXException

public SAXException(Exception e)

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

Существующее исключение будет вложено в новое, а его сообщение станет сообщением по умолчанию для SAXException.

Параметры:: e — Исключение, которое следует обернуть в SAXException.

SAXException

public SAXException(String message, Exception e)

Создает новый SAXException на основе существующего исключения.

Существующее исключение будет вложено в новое, но у нового исключения будет собственное сообщение.

Параметры:: message — Подробное сообщение.; e — Исключение, которое следует обернуть в SAXException.

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

getMessage

public String getMessage()

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

Если имеется вложенное исключение и SAXException не содержит собственного подробного сообщения, этот метод вернет подробное сообщение вложенного исключения.

Переопределяет:: getMessage в классе Throwable
Возвращает:: Сообщение об ошибке или предупреждении.

getException

public Exception getException()

Возвращает вложенное исключение, если оно есть.

Возвращает:: Вложенное исключение или null, если его нет.

getCause

public Throwable getCause()

Возвращает причину исключения

Переопределяет:: getCause в классе Throwable
Возвращает:: Возвращает причину исключения

toString

public String toString()

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

Переопределяет:: toString в классе Throwable
Возвращает:: Строковое представление этого исключения.

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