Интерфейс DeclHandler

public interface DeclHandler

Обработчик расширения SAX2 для событий объявления DTD.

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

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

Обратите внимание, что объявления DTD, связанные с данными (непроанализированные сущности и обозначения), уже сообщаются через интерфейс DTDHandler.

Если вы используете обработчик объявлений вместе с лексическим обработчиком, все события будут происходить между событиями startDTD и endDTD.

Чтобы установить DeclHandler для XML-читателя, используйте метод setProperty с именем свойства http://xml.org/sax/properties/declaration-handler и объектом, реализующим этот интерфейс (или null), в качестве значения. Если читатель не сообщает события объявления, он выбросит SAXNotRecognizedException, когда вы попытаетесь зарегистрировать обработчик.

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

elementDecl

void elementDecl(String name,
                 String model)
          throws SAXException

Параметры:

name - Имя типа элемента.

model - Модель содержимого в виде нормализованной строки.

Исключения:

SAXException - Приложение может вызывать исключение.

attributeDecl

void attributeDecl(String eName,
                   String aName,
                   String type,
                   String mode,
                   String value)
            throws SAXException

Параметры:

eName - Имя связанного элемента.

aName - Имя атрибута.

type - Строка, представляющая тип атрибута.

mode - Строка, представляющая режим определения атрибута ("#IMPLIED", "#REQUIRED" или "#FIXED") или null, если ни одно из них не применяется.

value - Строка, представляющая значение атрибута по умолчанию, или null, если его нет.

Исключения:

SAXException - Приложение может вызывать исключение.

internalEntityDecl

void internalEntityDecl(String name,
                        String value)
                 throws SAXException

Параметры:

name - Имя сущности. Если это параметрическая сущность, имя будет начинаться с '%'.

value - Заменяющий текст сущности.

Исключения:

SAXException - Приложение может вызывать исключение.

См. также:

externalEntityDecl(java.lang.String, java.lang.String, java.lang.String), DTDHandler.unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)

externalEntityDecl

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

Параметры:

name - Имя сущности. Если это параметрическая сущность, имя будет начинаться с '%'.

publicId - Общественный идентификатор сущности или null, если он не был задан.

systemId - Идентификатор системы сущности.

Исключения:

SAXException - Приложение может вызывать исключение.

См. также:

internalEntityDecl(java.lang.String, java.lang.String), DTDHandler.unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)