Интерфейс Parser

Все известные реализующие классы:: XMLReaderAdapter

Устарело.

Этот интерфейс был заменен интерфейсом SAX2 XMLReader, который включает поддержку пространств имен.

public interface Parser

Базовый интерфейс для парсеров SAX (Simple API for XML).

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

Это был основной интерфейс поставщика событий для SAX1; он был заменен в SAX2 на XMLReader, который включает поддержку пространств имен и сложные возможности настройки и расширения.

Все парсеры SAX1 должны реализовывать этот базовый интерфейс: он позволяет приложениям регистрировать обработчики для различных типов событий и инициировать разбор из URI или потока символов.

Все парсеры SAX1 также должны реализовывать конструктор без аргументов (хотя также допускаются и другие конструкторы).

Парсеры SAX1 являются многоразовыми, но не реентерабельными: приложение может повторно использовать объект парсера (возможно, с другим источником ввода) после успешного завершения первого анализа, но оно не может вызывать методы parse() рекурсивно во время анализа.

С момента:: SAX 1.0
См. также:: EntityResolver, DTDHandler, DocumentHandler, ErrorHandler, HandlerBase, InputSource

Краткое описание методов

Модификатор и тип	Метод и описание
`void`	`parse(InputSource source)` Устарело. Разбор XML-документа.
`void`	`parse(String systemId)` Устарело. Разбор XML-документа из системного идентификатора (URI).
`void`	`setDocumentHandler(DocumentHandler handler)` Устарело. Разрешить приложению зарегистрировать обработчик событий документа.
`void`	`setDTDHandler(DTDHandler handler)` Устарело. Разрешить приложению зарегистрировать обработчик событий DTD.
`void`	`setEntityResolver(EntityResolver resolver)` Устарело. Разрешить приложению зарегистрировать пользовательский решатель сущностей.
`void`	`setErrorHandler(ErrorHandler handler)` Устарело. Разрешить приложению зарегистрировать обработчик событий ошибок.
`void`	`setLocale(Locale locale)` Устарело. Разрешить приложению запросить локаль для ошибок и предупреждений.

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

setLocale

void setLocale(Locale locale)
        throws SAXException

Устарело.

Разрешить приложению запросить локаль для ошибок и предупреждений.

Парсеры SAX не обязаны предоставлять локализацию для ошибок и предупреждений; однако, если они не могут поддерживать запрашиваемую локаль, они должны выбросить исключение SAX. Приложения не могут запрашивать изменение локали во время анализа.

Параметры:: locale - Объект Java Locale.
Исключения:: SAXException - Выбрасывает исключение (используя предыдущую или локаль по умолчанию), если запрашиваемая локаль не поддерживается.
См. также:: SAXException, SAXParseException

setEntityResolver

void setEntityResolver(EntityResolver resolver)

Устарело.

Разрешить приложению зарегистрировать пользовательский решатель сущностей.

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

Приложения могут зарегистрировать новый или другой решатель сущностей во время анализа, и парсер SAX должен немедленно начать использовать новый решатель.

Параметры:: resolver - Объект для разрешения сущностей.
См. также:: EntityResolver, HandlerBase

setDTDHandler

void setDTDHandler(DTDHandler handler)

Устарело.

Разрешить приложению зарегистрировать обработчик событий DTD.

Если приложение не регистрирует обработчик DTD, все события DTD, сообщенные парсером SAX, будут игнорироваться (это поведение по умолчанию, реализованное HandlerBase).

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

Параметры:: handler - Обработчик DTD.
См. также:: DTDHandler, HandlerBase

setDocumentHandler

void setDocumentHandler(DocumentHandler handler)

Устарело.

Разрешить приложению зарегистрировать обработчик событий документа.

Если приложение не регистрирует обработчик документа, все события документа, сообщенные парсером SAX, будут игнорироваться (это поведение по умолчанию, реализованное HandlerBase).

Параметры:: handler - Обработчик документа.
См. также:: DocumentHandler, HandlerBase

setErrorHandler

void setErrorHandler(ErrorHandler handler)

Устарело.

Разрешить приложению зарегистрировать обработчик событий ошибок.

Если приложение не регистрирует обработчик событий ошибок, все события ошибок, сообщенные парсером SAX, будут игнорироваться, за исключением fatalError, который выбросит SAXException (это поведение по умолчанию, реализованное HandlerBase).

Параметры:: handler - Обработчик ошибок.
См. также:: ErrorHandler, SAXException, HandlerBase

parse

void parse(InputSource source)
    throws SAXException,
           IOException

Устарело.

Разбор XML-документа.

Приложение может использовать этот метод, чтобы указать парсеру SAX начать разбор XML-документа из любого допустимого источника ввода (поток символов, поток байтов или URI).

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

Параметры:: source - Источник ввода для верхнего уровня XML-документа.
Исключения:: SAXException - Любое исключение SAX, возможно, оборачивающее другое исключение.; IOException - IO-исключение от парсера, возможно, из потока байтов или потока символов, предоставленного приложением.
См. также:: InputSource, parse(java.lang.String), setEntityResolver(org.xml.sax.EntityResolver), setDTDHandler(org.xml.sax.DTDHandler), setDocumentHandler(org.xml.sax.DocumentHandler), setErrorHandler(org.xml.sax.ErrorHandler)

parse

void parse(String systemId)
    throws SAXException,
           IOException

Устарело.

Разбор XML-документа из системного идентификатора (URI).

Этот метод является сокращением для распространенного случая чтения документа из системного идентификатора. Он является полным эквивалентом следующего:

parse(new InputSource(systemId));

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

Параметры:: systemId - Системный идентификатор (URI).
Исключения:: SAXException - Любое исключение SAX, возможно, оборачивающее другое исключение.; IOException - IO-исключение от парсера, возможно, из потока байтов или потока символов, предоставленного приложением.
См. также:: parse(org.xml.sax.InputSource)

© 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.