Класс 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

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

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.xml/org/xml/sax/SAXParseException.html