29.6. xml.sax.handler - базовые классы для обработчиков ... 395

feature validation

Сообщать о несоответствии документа DTD.

feature external ges

Подключать внешние объявления текстовых сущностей.

feature external pes

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

all features

Список, содержащий все известные особенности.

property lexical handler

Необязательный обработчик лексических событий (например, комментариев). В версии 2.0 не поддерживается.

property declaration handler

Необязательный обработчик событий, связанных с DTD (кроме необрабатываемых сущностей и примечаний). В версии 2.0 не поддерживается.

property dom node

До начала синтаксического анализа - корневой, во время анализа - текущий узел объектной модели документа (DOM). Изменение этого свойства возможно только до начала анализа документа.

property xml string

Строка, содержащая фрагмент исходного текста документа для текущего события. Свойство доступно только для чтения.

all properties

Список всех известных имен свойств.

29.6.1 Интерфейс класса ContentHandler

Интерфейс класса ContentHandler составляют следующие методы:

setDocumentLocator( locator)

Вызывается синтаксическим анализатором XML-документа перед началом анализа. Объект locator (должен быть экземпляром xml.sax.xmlreader.Locator) предоставляет возможность получить информацию о позиции в документе соответствующей текущему событию. Эта информация обычно используется для вывода сообщений об ошибке. Заметим, что методы объекта locator должны возвращать корректный результат только во время обработки события.

startDocument()

Вызывается один раз для извещения о начале документа.

endDocument()

Вызывается один раз для извещения о конце документа (при достижении конца ввода или возникновении ошибки, не допускающей восстановления).

startPrefixMapping(prefix, uri)

Вызывается в начале области действия пространства имен. Обработка этого события не является необходимой: синтаксический анализатор XML-документа автоматически заменяет приставку prefix на URI uri в именах элементов и атрибутов, если включена возможность feature namespaces (эта возможность включена по умолчанию). Метод startPrefixMapping() всегда вызывается до соответствующего метода startElement() , однако правильный порядок следования нескольких событий startPrefixMapping() не гарантируется.

endPrefixMapping( prefix)

Вызывается в конце области действия пространства имен. Метод endPrefixMapping() всегда вызывается до соответствующего метода endElement() , однако правильный порядок следования нескольких событий endPrefixMapping() не гарантируется.

startElement( name, attrs)

Вызывается в начале элемента (без учета пространств имен). В качестве аргумента name используется строка с необработанным именем элемента, в качестве attrs - экземпляр класса xml.sax.xmlreader.Attributeslmpl, описывающий атрибуты элемента.

endElement( name)

Вызывается в начале элемента (без учета пространств имен). В качестве аргумента name используется строка с необработанным именем элемента.

startElementNS(name, qname, attrs)

Вызывается в начале элемента (с учетом пространств имен). В качестве аргумента name используется кортеж, содержащий URI и имя элемента, в качестве qname - строка с необработанным именем элемента (может быть None, если отключена возможность feature namespaces) и в качестве attrs - экземпляр класса xml.sax.xmlreader.AttributesNSImpl, описывающий атрибуты элемента.

endElementNS( name, qname)

Вызывается в конце элемента (с учетом пространств имен). В качестве аргумента name используется кортеж, содержащий URI и имя элемента, в качестве qname - строка с необработанным именем элемента (может быть None, если отключена возможность feature namespaces).

characters( content)

Вызывается для символьных данных (аргумент content). Синтаксический анализатор документа может передавать непрерывный поток символьных данных этому методу несколькими порциями. Все символы, переданные методу одной порцией должны быть из одного элемента. Аргумент content может быть как обычной строкой, так и строкой Unicode.

29.6. xml.sax.handler - базовые классы для обработчиков ... 397

ignorableWhitespace(whitespace)

Вызывается для символов пропуска (аргумент whitespace) в содержимом элемента, которые могут быть проигнорированы. Синтаксический анализатор документа может передавать непрерывный поток символов пропуска этому методу несколькими порциями. Все символы пропуска, переданные методу одной порцией должны быть из одного элемента.

processingInstruction( target , data)

Вызывается для инструкций обработки вида <? target data?> . Этот метод не должен вызываться для объявлений вида <?xml ...>.

skippedEntity( name)

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

DTD).

29.6.2 Интерфейс класса DTDHandler

Интерфейс класса DTDHandler составляют следующие методы:

notationDecl( name, publicId, systemId)

Вызывается для обработки объявлений примечаний (<!NOTATlON ...>).

unparsedEntityDecl( name, publicId, systemId, ndata)

Вызывается для обработки объявлений необрабатываемых сущностей (NDATA).

29.6.3 Интерфейс класса ErrorHandler

Интерфейс класса ErrorHandler составляют следующие методы:

error( exception)

Вызывается для обработки ошибок, допускающих продолжение дальнейшей работы. Исходная реализация генерирует исключение exception.

fatalError( exception)

Вызывается для обработки фатальных ошибок, то есть, не допускающих продолжение дальнейшей работы. Исходная реализация генерирует исключение exception.

warning( exception)

Вызывается для предупреждений. Исходная реализация выводит на стандартный поток вывода (sys.stdout) строковое представление исключения exception.