Объекты CFXMLNode

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

Каждый CFXMLNode объект содержит три основных данные — тип узла, строка данных и указатель на структуру данных с дополнительной информацией. Вы извлекаете эти данные с помощью простых функций средства доступа. Тип узла кодируется как перечисление постоянное описание типа структуры XML. Строка данных всегда a CFString объект; значение строки зависит от идентификатора типа узла. Формат дополнительных данных также зависит от типа узла; существует определенная структура для каждого типа, требующего дополнительных данных.

Поскольку это обрабатывает XML-документ, синтаксический анализатор преобразовывает каждую конструкцию XML, с которой это встречается в a CFXMLNode объект, представляющий ту конструкцию. Например, при парсинге документа, показанного в Перечислении 1, синтаксический анализатор реагировал бы на тег <birthday> путем создания нового CFXMLNode чей тип узла был бы установлен в идентификатор kCFXMLNodeTypeElement. CFXMLNode строка данных содержала бы CFString возразите «дню рождения», и дополнительный указатель данных указал бы на a CFXMLElementInfo структура, содержащая информацию об атрибутах элемента.

Для обработки некоторых более сложных объектов XML Базовая Основа определяет несколько дополнительных структур данных. Структуры, содержащие дополнительную информацию, описаны кратко в Таблице 1.

Чтобы кратко проиллюстрировать, как эти структуры используются синтаксическим анализатором, считайте еще раз XML-документ показанным в Перечислении 1. Четвертая строка документа содержит тег <address region="USA">. Строка region="USA" определяет вызванный атрибут элемента region чье строковое значение USA. Атрибуты элемента являются способом связать дополнительные данные с данным элементом.

Синтаксический анализатор XML возвращает атрибуты тега Вашему приложению как a CFXMLElementInfo структура. Эта структура показана в Перечислении 1.

Перечисление 1  структура CFXMLElementInfo

typedef struct {

    CFDictionaryRef attributes;

    CFArrayRef attributeOrder;

    Boolean isEmpty;

} CFXMLElementInfo;

При парсинге этого тега синтаксический анализатор создает a CFXMLNode возразите, чей код типа kCFXMLNodeTypeElement, и чья строка данных “address”. Указатель дополнительной информации установлен указать на a CFXMLElementInfo структура, описывающая элемент и его атрибуты. attributes поле содержит a CFDictionary объект, содержащий данные атрибута в формате ключа/значения. attributeOrder поле содержит a CFArray объект, содержащий attributes словарь вводит порядок, с ними встретились. Булево значение isEmpty поле указывает, пуст ли элемент. Посмотрите, что Наборы Программируют Темы для Базовой Основы для получения дополнительной информации о CFDictionary и CFArray.

Основанный на дереве синтаксический анализатор API

Основанный на дереве синтаксический анализатор API обеспечивает очень простой метод для чтения данных XML. Один вызов к функции CFXMLTreeCreateFromData читает весь XML-документ — указанный указателем на данные XML в памяти, или строкой URL — и возвращает данные XML Вам в форме a CFXMLTree объект. A CFXMLTree объект просто a CFTree объект, содержащий указатель на a CFXMLNode объект в контексте каждого узла. Посмотрите, что Наборы Программируют Темы для Базовой Основы для получения дополнительной информации о CFTreeRef и его API.

Один раз CFXMLTree объект был создан, можно использовать CFTree API для исследования дерева и информации о выдержке от данного узла. Базовая Основа также обеспечивает функции удобства, делающие еще проще получить доступ к содержанию a CFXMLTree объект. Например, CFXMLTreeGetNode берет ссылку на один из узлов дерева и возвращает указатель на тот узел.

Раздел Используя Основанный на дереве Интерфейс Синтаксического анализатора показывает Вам, как проанализировать, исследовать, и изменить XML-документ с помощью основанного на дереве синтаксического анализатора API.

Событийно-управляемый синтаксический анализатор API

Основанный на дереве синтаксический анализатор XML API достаточен для многих потребностей. Однако существуют некоторые случаи где с помощью событийно-управляемого интерфейса CFXML является надлежащим:

• Вы хотите подстроенное управление процесса парсинга.

• Вам нужен доступ к данным в очень большом XML-документе и преобразовании всего документа в a CFXMLTree объект требует слишком большого количества памяти.

• A CFXMLTree объект является несоответствующим для потребностей Вашего приложения, и Вы хотите создать пользовательскую структуру данных из содержания XML-документа.

• Вы хотите обеспечить дополнительную проверку ошибок как анализирующий прогресс.

• Вы хотите управлять, когда и как загружаются внешние объекты.

Для этих и других ситуаций можно использовать основанный на обратном вызове событийно-управляемый API. Этот API несколько более сложен для использования, но обеспечивает намного больше гибкости, чем основанный на дереве API.

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