Класс SAXParseException

org.xml.sax.SAXParseException

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

public class SAXParseException extends SAXException

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

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

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

C момента:

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 из сообщения и Locator.

Этот конструктор особенно полезен, когда приложение создает собственное исключение внутри обратного вызова 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, 2023, 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/21/docs/api/java.xml/org/xml/sax/SAXParseException.html