Пожалуйста, учтите, что спецификации и другая информация, содержащаяся здесь, не являются заключительными и могут быть изменены. Информация доступна для вас исключительно ради ознакомления.
Получите уведомление об основных связанных с DTD событиях.
Этот модуль, и исходный код и документация, находится в Общедоступном Домене, и прибывает без ГАРАНТИИ. См. http://www.saxproject.org для дополнительной информации.
Если приложение SAX нуждается в информации о нотациях и непроанализированных объектах, то приложение реализует этот интерфейс и регистрирует экземпляр в синтаксическом анализаторе SAX, используя setDTDHandler метод синтаксического анализатора. Синтаксический анализатор использует экземпляр, чтобы сообщить о нотации и непроанализированных объявлениях объекта к приложению.
Отметьте, что этот интерфейс включает только те события DTD, о которых рекомендация XML требует, чтобы процессоры сообщили: нотация и непроанализированные объявления объекта.
Синтаксический анализатор SAX может сообщить об этих событиях в любом порядке, независимо от порядка, в котором были объявлены нотации и непроанализированные объекты; однако, обо всех событиях DTD нужно сообщить после startDocument события обработчика документа, и перед первым startElement событием. (Если LexicalHandler используется, об этих событиях нужно также сообщить перед endDTD событием.)
Это до приложения, чтобы хранить информацию для будущего использования (возможно, в хэш-таблице или возразить дереву). Если приложение встречается с атрибутами типа "НОТАЦИЯ", "ОБЪЕКТ", или "ОБЪЕКТЫ", это может использовать информацию, которую это получило через этот интерфейс, чтобы счесть объект и/или нотацию соответствующими со значением атрибута.
Получите уведомление о событии объявления нотации.
Это до приложения, чтобы записать нотацию для более поздней ссылки в случае необходимости; нотации могут появиться как значения атрибута и в непроанализированных объявлениях объекта, и когда-то используются с обработкой целевых имен инструкции.
По крайней мере один из publicId и systemId должен быть ненулем. Если системный идентификатор присутствует, и это - URL, синтаксический анализатор SAX должен разрешить это полностью прежде, чем передать это к приложению через это событие.
Нет никакой гарантии, что об объявлении нотации сообщат перед любыми непроанализированными объектами, которые используют его.
Параметры:
name - Имя нотации.
publicId - Общедоступный идентификатор нотации, или нуль, если ни один не был дан.
systemId - Системный идентификатор нотации, или нуль, если ни один не был дан.
Броски:
SAXException - Любое исключение SAX, возможно обертывая другое исключение.
Получите уведомление о непроанализированном событии объявления объекта.
Отметьте, что имя нотации соответствует нотации, о которой сообщают notationDecl событие. Это до приложения, чтобы записать объект для более поздней ссылки в случае необходимости; непроанализированные объекты могут появиться как значения атрибута.
Если системным идентификатором является URL, синтаксический анализатор должен разрешить это полностью прежде, чем передать его к приложению.
Параметры:
name - Имя непроанализированного объекта.
publicId - Общедоступный идентификатор объекта, или нуль, если ни один не был дан.
systemId - Системный идентификатор объекта.
notationName - Имя связанной нотации.
Броски:
SAXException - Любое исключение SAX, возможно обертывая другое исключение.