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

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

Параметры:

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

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

См. также:

Locator

SAXParseException

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

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

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

Параметры:

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

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

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

См. также:

Locator

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, если он недоступен.

См. также:

Locator.getPublicId()

getSystemId

public String getSystemId()

Получить системный идентификатор сущности, где произошла ошибка.

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

Возвращает:

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

См. также:

Locator.getSystemId()

getLineNumber

public int getLineNumber()

Номер строки конца текста, где произошла ошибка.

Первая строка — строка 1.

Возвращает:

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

См. также:

Locator.getLineNumber()

getColumnNumber

public int getColumnNumber()

Номер столбца конца текста, где произошла ошибка.

Первый столбец в строке — позиция 1.

Возвращает:

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

См. также:

Locator.getColumnNumber()

toString

public String toString()

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

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

© 1993, 2021, 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/17/docs/api/java.xml/org/xml/sax/SAXParseException.html