Интерфейс DTDHandler

Все известные подинтерфейсы:: TransformerHandler

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

public interface DTDHandler

Получить уведомление об основных событиях, связанных с DTD.

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

Если приложению SAX требуется информация о обозначениях и необработанных сущностях, то приложение реализует этот интерфейс и регистрирует экземпляр в анализаторе SAX с помощью метода parser's setDTDHandler. Анализатор использует экземпляр для сообщения приложению о декларациях обозначений и необработанных сущностей.

Обратите внимание, что этот интерфейс включает только те события DTD, которые рекомендует XML, процессоры обязаны сообщать: декларации обозначений и необработанных сущностей.

Анализатор SAX может сообщать об этих событиях в любом порядке, независимо от порядка, в котором были объявлены обозначения и необработанные сущности; однако все события DTD должны быть сообщены после события startDocument обработчика документов и перед первым событием startElement. (Если используется LexicalHandler, эти события также должны быть сообщены до события endDTD.)

Приложение должно хранить информацию для последующего использования (возможно, в хэш-таблице или дереве объектов). Если приложение встречает атрибуты типа "NOTATION", "ENTITY" или "ENTITIES", оно может использовать информацию, полученную через этот интерфейс, чтобы найти соответствующую сущность и/или обозначение со значением атрибута.

С:: SAX 1.0
См. также:: XMLReader.setDTDHandler(org.xml.sax.DTDHandler)

Методы

Модификатор и тип	Метод и описание
`void`	`notationDecl(String name, String publicId, String systemId)` Получить уведомление об событии объявления обозначения.
`void`	`unparsedEntityDecl(String name, String publicId, String systemId, String notationName)` Получить уведомление об событии объявления необработанной сущности.

Методы

notationDecl

void notationDecl(String name,
                  String publicId,
                  String systemId)
           throws SAXException

Получить уведомление об событии объявления обозначения.

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

По крайней мере, один из publicId и systemId должен быть не null. Если идентификатор системы присутствует и является URL-адресом, анализатор SAX должен полностью разрешить его перед передачей приложению через это событие.

Нет гарантии, что декларация обозначения будет сообщена до любых необработанных сущностей, которые ее используют.

Параметры:: name - Название обозначения.; publicId - Открытый идентификатор обозначения или null, если он не был задан.; systemId - Идентификатор системы обозначения или null, если он не был задан.
Исключения:: SAXException - Любое исключение SAX, возможно, обертывающее другое исключение.
См. также:: unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String), Attributes

unparsedEntityDecl

void unparsedEntityDecl(String name,
                        String publicId,
                        String systemId,
                        String notationName)
                 throws SAXException

Получить уведомление об событии объявления необработанной сущности.

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

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

Параметры:: name - Имя необработанной сущности.; publicId - Открытый идентификатор сущности или null, если он не был задан.; systemId - Идентификатор системы сущности.; notationName - Имя связанного обозначения.
Исключения:: SAXException - Любое исключение SAX, возможно, обертывающее другое исключение.
См. также:: notationDecl(java.lang.String, java.lang.String, java.lang.String), Attributes

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