Интерфейс ErrorHandler

Все известные реализующие классы:: DefaultHandler, DefaultHandler2, HandlerBase, XMLFilterImpl

public interface ErrorHandler

Базовый интерфейс для обработчиков ошибок SAX.

Этот модуль, как исходный код, так и документация, находится в общественном достоянии и не несёт НИКАКОЙ ГАРАНТИИ. Дополнительная информация доступна на http://www.saxproject.org.

Если приложению SAX требуется реализовать настраиваемую обработку ошибок, оно должно реализовать этот интерфейс и затем зарегистрировать экземпляр с помощью XML-ридера, используя метод setErrorHandler. Парсер затем сообщит обо всех ошибках и предупреждениях через этот интерфейс.

ПРЕДУПРЕЖДЕНИЕ: Если приложение не зарегистрирует ErrorHandler, ошибки парсинга XML останутся неотмеченными, за исключением SAXParseException, которые будут выброшены для критических ошибок. Для обнаружения ошибок валидности необходимо зарегистрировать ErrorHandler, который что-то делает с вызовами error().

Для ошибок обработки XML драйвер SAX должен использовать этот интерфейс вместо выброса исключения: приложение должно решить, выбросить ли исключение для различных типов ошибок и предупреждений. Обратите внимание, что нет требования о том, что парсер продолжит сообщать об дополнительных ошибках после вызова fatalError. Другими словами, класс драйвера SAX может выбросить исключение после сообщения о любой критической ошибке. Также парсеры могут выбросить соответствующие исключения для ошибок, не связанных с XML. Например, XMLReader.parse() выбросит IOException для ошибок доступа к сущностям или документу.

Дата введения:: SAX 1.0
См. также:: XMLReader.setErrorHandler(org.xml.sax.ErrorHandler), SAXParseException

Методы

Модификатор и тип	Метод и описание
`void`	`error(SAXParseException exception)` Получение уведомления о восстанавливаемой ошибке.
`void`	`fatalError(SAXParseException exception)` Получение уведомления о невосстанавливаемой ошибке.
`void`	`warning(SAXParseException exception)` Получение уведомления о предупреждении.

Методы

warning

void warning(SAXParseException exception)
      throws SAXException

Получение уведомления о предупреждении.

SAX-парсеры будут использовать этот метод для сообщения о ситуациях, которые не являются ошибками или критическими ошибками, как определено в рекомендации W3C по XML. По умолчанию поведение не выполняет никаких действий.

SAX-парсер должен продолжать предоставлять обычные события парсинга после вызова этого метода: приложение всё ещё должно иметь возможность обработать документ до конца.

Фильтры могут использовать этот метод для сообщения и о других предупреждениях, не связанных с XML.

Параметры:: exception - Информация о предупреждении, инкапсулированная в исключении SAX-парсинга.
Исключения:: SAXException - Любое исключение SAX, возможно, обертывающее другое исключение.
См. также:: SAXParseException

error

void error(SAXParseException exception)
    throws SAXException

Получение уведомления о восстанавливаемой ошибке.

Это соответствует определению "ошибки" в разделе 1.2 рекомендации W3C по XML 1.0. Например, валидирующий парсер будет использовать этот обработчик для сообщения о нарушении ограничения валидности. По умолчанию поведение не выполняет никаких действий.

SAX-парсер должен продолжать предоставлять обычные события парсинга после вызова этого метода: приложение всё ещё должно иметь возможность обработать документ до конца. Если приложение не может сделать этого, парсер должен сообщить о критической ошибке, даже если этого не требует рекомендация XML.

Фильтры могут использовать этот метод для сообщения и о других, не связанных с XML, ошибках.

Параметры:: exception - Информация об ошибке, инкапсулированная в исключении SAX-парсинга.
Исключения:: SAXException - Любое исключение SAX, возможно, обертывающее другое исключение.
См. также:: SAXParseException

fatalError

void fatalError(SAXParseException exception)
         throws SAXException

Получение уведомления о невосстанавливаемой ошибке.

Существует явное противоречие между документацией этого метода и документацией для ContentHandler.endDocument(). До тех пор, пока эта неоднозначность не будет решена в будущей основной версии, клиенты не должны делать предположений о том, будет ли вызван endDocument() при сообщении о fatalError() или выбросе исключения.

Это соответствует определению "критической ошибки" в разделе 1.2 рекомендации W3C по XML 1.0. Например, парсер будет использовать этот обработчик для сообщения о нарушении ограничения хорошо сформированности.

Приложение должно предполагать, что документ непригоден для использования после вызова парсером этого метода и должно продолжать (если вообще) только для сбора дополнительных сообщений об ошибках: фактически, SAX-парсеры могут прекратить сообщение о других событиях после вызова этого метода.

Параметры:: exception - Информация об ошибке, инкапсулированная в исключении SAX-парсинга.
Исключения:: SAXException - Любое исключение SAX, возможно, обертывающее другое исключение.
См. также:: SAXParseException

© 1993, 2020, 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.