Интерфейс DTDHandler

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

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

public interface DTDHandler

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

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

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

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

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

С:

1.4, 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, 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/DTDHandler.html