Класс SAXParseException

org.xml.sax.SAXParseException

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

public class SAXParseException extends SAXException

Инкапсулирует ошибку или предупреждение при разборе XML.

Это исключение может содержать информацию, позволяющую найти ошибку в исходном XML-документе, как если бы она была получена от объекта Locator. Обратите внимание: хотя приложение получит SAXParseException в качестве аргумента обработчикам интерфейса ErrorHandler, приложение не обязано выбрасывать это исключение; вместо этого оно может просто прочитать содержащуюся в нём информацию и выполнить другое действие.

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

Начиная с:

1.4, SAX 1.0

См. также:

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

Конструктор	Описание
`SAXParseException(String message, String publicId, String systemId, int lineNumber, int columnNumber)`	Создаёт новый SAXParseException.
`SAXParseException(String message, String publicId, String systemId, int lineNumber, int columnNumber, Exception e)`	Создаёт новый SAXParseException со встроенным исключением.
`SAXParseException(String message, Locator locator)`	Создаёт новый SAXParseException на основе сообщения и объекта Locator.
`SAXParseException(String message, Locator locator, Exception e)`	Оборачивает существующее исключение в SAXParseException.

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

Модификатор и тип	Метод	Описание
`int`	`getColumnNumber()`	Номер столбца в конце текста, в котором произошло исключение.
`int`	`getLineNumber()`	Номер строки в конце текста, в котором произошло исключение.
`String`	`getPublicId()`	Возвращает общедоступный идентификатор сущности, в которой произошло исключение.
`String`	`getSystemId()`	Возвращает системный идентификатор сущности, в которой произошло исключение.
`String`	`toString()`	Переопределяет toString для предоставления более подробного сообщения об ошибке.

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

getCause, getException, getMessage

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

Методы, объявленные в классе 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)`	Выводит это исключение и его трассировку в указанный объект PrintWriter.
`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, либо до истечения заданного интервала реального времени.

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

SAXParseException

public SAXParseException(String message, Locator locator)

Создаёт новый SAXParseException на основе сообщения и объекта Locator.

Этот конструктор особенно полезен, если приложение создаёт собственное исключение внутри обратного вызова ContentHandler.

Параметры:

message — Сообщение об ошибке или предупреждении.

locator — Объект locator для ошибки или предупреждения (может быть null).

См. также:

SAXParseException

public SAXParseException(String message, Locator locator, Exception e)

Оборачивает существующее исключение в SAXParseException.

Этот конструктор особенно полезен, если приложение создаёт собственное исключение внутри обратного вызова ContentHandler и ему нужно обернуть существующее исключение, которое не является подклассом SAXException.

Параметры:

message — Сообщение об ошибке или предупреждении либо null, чтобы использовать сообщение встроенного исключения.

locator — Объект locator для ошибки или предупреждения (может быть null).

e — Любое исключение.

См. также:

SAXParseException

public SAXParseException(String message, String publicId, String systemId, int lineNumber, int columnNumber)

Создаёт новый SAXParseException.

Этот конструктор наиболее полезен разработчикам парсеров.

Все параметры, кроме сообщения, соответствуют параметрам, которые предоставил бы объект Locator. Например, если системный идентификатор является URL (в том числе относительным именем файла), вызывающий код должен полностью разрешить его перед созданием исключения.

Параметры:: message — Сообщение об ошибке или предупреждении.; publicId — Общедоступный идентификатор сущности, вызвавшей ошибку или предупреждение.; systemId — Системный идентификатор сущности, вызвавшей ошибку или предупреждение.; lineNumber — Номер строки в конце текста, вызвавшего ошибку или предупреждение.; columnNumber — Номер столбца в конце текста, вызвавшего ошибку или предупреждение.

SAXParseException

public SAXParseException(String message, String publicId, String systemId, int lineNumber, int columnNumber, Exception e)

Создаёт новый SAXParseException со встроенным исключением.

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

Все параметры, кроме сообщения и исключения, соответствуют параметрам, которые предоставил бы объект Locator. Например, если системный идентификатор является URL (в том числе относительным именем файла), вызывающий код должен полностью разрешить его перед созданием исключения.

Параметры:: message — Сообщение об ошибке или предупреждении либо null, чтобы использовать сообщение встроенного исключения.; publicId — Общедоступный идентификатор сущности, вызвавшей ошибку или предупреждение.; systemId — Системный идентификатор сущности, вызвавшей ошибку или предупреждение.; lineNumber — Номер строки в конце текста, вызвавшего ошибку или предупреждение.; columnNumber — Номер столбца в конце текста, вызвавшего ошибку или предупреждение.; e — Другое исключение, которое нужно встроить в это исключение.

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

getPublicId

public String getPublicId()

Возвращает общедоступный идентификатор сущности, в которой произошло исключение.

Возвращает:

Строку с общедоступным идентификатором или null, если он недоступен.

См. также:

getSystemId

public String getSystemId()

Возвращает системный идентификатор сущности, в которой произошло исключение.

Если системный идентификатор является URL, он будет полностью разрешён.

Возвращает:

Строку с системным идентификатором или null, если он недоступен.

См. также:

getLineNumber

public int getLineNumber()

Номер строки в конце текста, в котором произошло исключение.

Нумерация строк начинается с 1.

Возвращает:

Целое число, представляющее номер строки, или -1, если он недоступен.

См. также:

getColumnNumber

public int getColumnNumber()

Номер столбца в конце текста, в котором произошло исключение.

Нумерация столбцов в строке начинается с позиции 1.

Возвращает:

Целое число, представляющее номер столбца, или -1, если он недоступен.

См. также:

toString

public String toString()

Переопределяет toString для предоставления более подробного сообщения об ошибке.

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

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