Класс 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 для предоставления более подробного сообщения об ошибке.

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

getCause, getException, getMessage

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

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

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

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

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

SAXParseException

public SAXParseException(String message, Locator locator)

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

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

Параметры:

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

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

См. также:

SAXParseException

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

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

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

Параметры:

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

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://download.java.net/java/early_access/jdk24/docs/api/java.xml/org/xml/sax/SAXParseException.html