org.xml.sax.ext

Интерфейсный DeclHandler

Все Известные Классы с реализацией:

DefaultHandler2

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 и объект, реализовывая этот интерфейс (или нуль) как значение. Если читатель не сообщит о событиях объявления, то это бросит a SAXNotRecognizedException когда Вы пытаетесь зарегистрировать обработчик.

С тех пор:

SAX 2.0 (расширения 1.0)

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	attributeDecl(String eName, String aName, String type, String mode, String value) Сообщите об описании типа атрибута.
void	elementDecl(String name, String model) Сообщите об описании типа элемента.
void	externalEntityDecl(String name, String publicId, String systemId) Сообщите о проанализированном внешнем объявлении объекта.
void	internalEntityDecl(String name, String value) Сообщите о внутреннем объявлении объекта.

Деталь метода

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

Сообщите об описании типа атрибута.

Только об эффективном (первом) объявлении для атрибута сообщат. Тип будет одной из строк "CDATA", "ID", "IDREF", "IDREFS", "NMTOKEN", "NMTOKENS", "ОБЪЕКТ", "ОБЪЕКТЫ", заключенная в скобки маркерная группа с разделителем "|" и весь пробел, удаленный, или слово "НОТАЦИЯ", сопровождаемая пространством, сопровождаемым заключенной в скобки маркерной группой со всем удаленным пробелом.

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

Параметры:

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

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

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

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

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

Броски:

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

Сообщите о проанализированном внешнем объявлении объекта.

Только об эффективном (первом) объявлении для каждого объекта сообщат.

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

Параметры:

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

publicId - Общедоступный идентификатор объекта, или нуль, если ни один не был дан.

systemId - Системный идентификатор объекта.

Броски:

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

См. Также:

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