Qt:Документация 4.3.2/qtxml
Материал из Wiki.crossplatform.ru
Root (Обсуждение | вклад) (Новая: {{Qt4.3.2_header}} [Previous: QtSvg Module] [ Qt's Modules ] [Next: [[Qt:Документа...) |
Geb (Обсуждение | вклад) (→Namespace Support via Features) |
||
(15 промежуточных версий не показаны.) | |||
Строка 1: | Строка 1: | ||
{{Qt4.3.2_header}} | {{Qt4.3.2_header}} | ||
- | [ | + | [Предыдущая: [[Qt:Документация 4.3.2/qtscript | Модуль QtScript]] ] [ [[Qt:Документация 4.3.2/modules | Модули Qt]] ] [Следующая: [[Qt:Документация 4.3.2/qtdesigner | Модуль QtDesigner]] ] |
=Модуль QtXml<br />= | =Модуль QtXml<br />= | ||
+ | |||
Модуль QtXml обеспечивает работу с потоками чтения и записи XML документов и реализацию их в форме SAX и DOM. [[#details | Далее...]] | Модуль QtXml обеспечивает работу с потоками чтения и записи XML документов и реализацию их в форме SAX и DOM. [[#details | Далее...]] | ||
==Классы== | ==Классы== | ||
+ | |||
{| width="100%" class="annotated" cellpadding="2" cellspacing="1" border="0" | {| width="100%" class="annotated" cellpadding="2" cellspacing="1" border="0" | ||
Строка 124: | Строка 126: | ||
|Запись XML с простым потоковым API | |Запись XML с простым потоковым API | ||
|} | |} | ||
- | + | <div id="details"></div> | |
==Подробное описание== | ==Подробное описание== | ||
- | |||
- | + | SAX это стандартный, основанный на событиях интерфейс для XML парсеров. Qt интерфейс соответствует возможностям SAX2 Java. Его схема именования была адаптирована согласно соглашений именования, принятых в Qt. Подробное описание SAX2 может быть найдено на [http://www.saxproject.org http://www.saxproject.org]. | |
- | + | Поддержка для фильтров SAX2 и reader factory находятся в стадии разработки. Данная версия Qt не обеспечивает совместимости с классами SAX1, представленными в Java интерфейсе. Введение в классы Qt SAX2 смотрите на [[#the-qt-sax2-classes | Классы Qt SAX2]]. | |
- | + | DOM Level 2 это W3C Recommendation для XML интерфейсов, которые отображают содержание XML документа в виде дерева. Спецификация DOM Level 2 может быть найдена на [http://www.w3.org/DOM/ http://www.w3.org/DOM/]. Дополнительную информацию о классах DOM в Qt представлена в [[#the-qt-dom-classes | Классы Qt DOM]]. | |
- | + | Начиная с версии 4.3, Qt ввела два новых класса для чтения и записи XML: [[Qt:Документация 4.3.2/qxmlstreamreader | QXmlStreamReader]] и [[Qt:Документация 4.3.2/qxmlstreamwriter | QXmlStreamWriter]]. | |
- | + | Дополнительно возможности XML обеспечивают [[Qt:Документация 4.3.2/qsvgrenderer | QSvgRenderer]] чтение поднабора SVG. Также развитие XML осуществляется группой [http://www.trolltech.com/products/qt/addon/solutions/ Qt Solutions], которая разрабатывает, например, классы для поддержки SOAP и MML на основе классов Qt XML. | |
+ | |||
+ | Для подключения модуля с классами нужно использовать следующую директиву: | ||
<source lang="cpp-qt"> #include <QtXml></source> | <source lang="cpp-qt"> #include <QtXml></source> | ||
- | + | Чтобы соединиться с модулем добавьте данную строку в ваш [[Qt:Документация 4.3.2/qmake-manual#qmake | qmake]] <tt>.pro</tt> файл: | |
<source lang="cpp-qt"> QT += xml</source> | <source lang="cpp-qt"> QT += xml</source> | ||
- | + | Данный модуль это часть [[Qt:Документация 4.3.2/commercialeditions#qt-console-edition | Qt Console Edition]], [[Qt:Документация 4.3.2/commercialeditions#qt-desktop-edition | Qt Desktop Edition]] и [[Qt:Документация 4.3.2/opensourceedition | Qt Open Source Edition]]. | |
+ | |||
+ | Разделы: | ||
+ | *[[#configuring-the-build-process | Конфигурирование процесса сборки]] | ||
+ | *[[#the-qtxml-stream-classes | Классы потока QtXml]] | ||
+ | *[[#the-qt-sax2-classes | Классы Qt SAX2]] | ||
+ | **[[#introduction-to-sax2 | Введение в SAX2]] | ||
+ | **[[#sax2-features | Особенности SAX2]] | ||
+ | **[[#namespace-support-via-features | Поддержка пространства имен]] | ||
+ | ***[[#summary | Итоги]] | ||
+ | **[[#properties | Свойства]] | ||
+ | *[[#the-qt-dom-classes | Классы Qt DOM]] | ||
+ | **[[#introduction-to-dom | Введение в DOM]] | ||
+ | *[[#an-introduction-to-namespaces | Введение в пространство имен]] | ||
+ | **[[#conventions-used-in-the-qt-xml-documentation | Соглашения, используемые в документации Qt XML]] | ||
- | === | + | <div id="configuring-the-build-process"></div> |
- | + | ===Конфигурирование процесса сборки=== | |
+ | Приложения, использующие классы Qt XML, должны быть собраны вместе с модулем QtXml. Следующее объявление в <tt>qmake</tt> файла проекта гарантирует, что приложение скомпилируется и отредактируется (linked) соответствующим образом: | ||
<source lang="cpp-qt"> QT += xml</source> | <source lang="cpp-qt"> QT += xml</source> | ||
- | + | Данная строка необходима, поскольку только модули [[Qt:Документация 4.3.2/qtcore | QtCore]] и [[Qt:Документация 4.3.2/qtgui | QtGui]] используются по умолчанию в процессе сборки. | |
+ | <div id="the-qtxml-stream-classes"></div> | ||
- | === | + | ===Классы потока QtXml=== |
- | + | [[Qt:Документация 4.3.2/qxmlstreamreader | QXmlStreamReader]] и [[Qt:Документация 4.3.2/qxmlstreamwriter | QXmlStreamWriter]] это два новых класса, появившихся начиная с версии Qt 4.3. Потоковый модуль чтения представляет XML документ как поток токенов (tokens). Это отличие от SAX, т.к. SAX приложения обеспечивают обработку поступающих событий XML от парсера, тогда как [[Qt:Документация 4.3.2/qxmlstreamreader | QXmlStreamReader]] передача осуществляется циклически, втягивая токены из модуля чтения, когда они требуются. Данный подход, основанный на втягивании, предоставляет возможность строить парсеры с рекурсивной обработкой, позволяя разделить код, выполняющий синтаксический анализ XML, на различные методы и классы. | |
- | [[Qt:Документация 4.3.2/qxmlstreamreader | QXmlStreamReader]] | + | [[Qt:Документация 4.3.2/qxmlstreamreader | QXmlStreamReader]] это парсеры, обеспечивающие обработку правильных (well-formed) XML документов, за исключением внешних сущностей. Следовательно, данные обрабатываемые потоковым модулем чтения удовлетворяют критерию W3C для правильных (well-formed) XML, что позволит избежать ошибок. С другой стороны, такие функции как [[Qt:Документация 4.3.2/qxmlstreamreader#atEnd | atEnd()]], [[Qt:Документация 4.3.2/qxmlstreamreader#error | error()]] и [[Qt:Документация 4.3.2/qxmlstreamreader#hasError | hasError()]] могут быть использованы для проверки и отображения ошибок. |
- | + | Примером использования [[Qt:Документация 4.3.2/qxmlstreamreader | QXmlStreamReader]] может быть <tt>XbelReader</tt> в [[Qt:Документация 4.3.2/xml-streambookmarks | QXmlStream Bookmarks Example]], который является подклассом QXmlStreamReder. Конструктор принимает ''treeWidget'' в качестве параметра и класс получает доступ к специфическим функциям Xbel: | |
<source lang="cpp-qt"> XbelReader(QTreeWidget *treeWidget); | <source lang="cpp-qt"> XbelReader(QTreeWidget *treeWidget); | ||
... | ... | ||
Строка 166: | Строка 185: | ||
QTreeWidget *treeWidget; | QTreeWidget *treeWidget; | ||
...</source> | ...</source> | ||
- | + | Функция <tt>read()</tt> принимает [[Qt:Документация 4.3.2/qiodevice | QIODevice]] и пердает его в [[Qt:Документация 4.3.2/qxmlstreamreader#setDevice | setDevice()]]. Функция [[Qt:Документация 4.3.2/qxmlstreamreader#raiseError | raiseError()]] используется для отображения пользовательских сообщений об ошибках, показывая, что версия файла некорректна. | |
<source lang="cpp-qt"> bool XbelReader::read(QIODevice *device) | <source lang="cpp-qt"> bool XbelReader::read(QIODevice *device) | ||
{ | { | ||
Строка 178: | Строка 197: | ||
readXBEL(); | readXBEL(); | ||
else | else | ||
- | raiseError(QObject::tr(" | + | raiseError(QObject::tr("Файл не является файлом XBEL версии 1.0.")); |
} | } | ||
} | } | ||
Строка 184: | Строка 203: | ||
return !error(); | return !error(); | ||
}</source> | }</source> | ||
- | + | Дополнением к [[Qt:Документация 4.3.2/qxmlstreamreader | QXmlStreamReader]] является [[Qt:Документация 4.3.2/qxmlstreamwriter | QXmlStreamWriter]]. Он представляет собой модуль записи XML с простым потоковым API. [[Qt:Документация 4.3.2/qxmlstreamwriter | QXmlStreamWriter]] функционирует на основе [[Qt:Документация 4.3.2/qiodevice | QIODevice]]. Он включает специальные функции для токенов или событий XML, которые вы хотите записать. Это [[Qt:Документация 4.3.2/qxmlstreamwriter#writeDTD | writeDTD()]], [[Qt:Документация 4.3.2/qxmlstreamwriter#writeCharacters | writeCharacters()]], [[Qt:Документация 4.3.2/qxmlstreamwriter#writeComment | writeComment()]] и т.д. | |
- | + | Для того, чтобы записать XML документ с помощью [[Qt:Документация 4.3.2/qxmlstreamwriter | QXmlStreamWriter]], документ должен начинаться с функции [[Qt:Документация 4.3.2/qxmlstreamwriter#writeStartDocument | writeStartDocument()]] и заканчиваться функцией [[Qt:Документация 4.3.2/qxmlstreamwriter#writeEndDocument | writeEndDocument()]], которая закроет все оставшиеся открытые теги. Теги элементов открываются [[Qt:Документация 4.3.2/qxmlstreamwriter#writeStartDocument | writeStartDocument()]], далее следуют [[Qt:Документация 4.3.2/qxmlstreamwriter#writeAttribute | writeAttribute()]] или [[Qt:Документация 4.3.2/qxmlstreamwriter#writeAttributes | writeAttributes()]], содержание элемента и в конце [[Qt:Документация 4.3.2/qxmlstreamwriter#writeEndDocument | writeEndDocument()]]. Для записи пустого элемента может быть использован [[Qt:Документация 4.3.2/qxmlstreamwriter#writeEmptyElement | writeEmptyElement()]]. | |
- | + | Содержание элемента представляет собой набор символов, ссылки на сущности или вложенные элементы. Содержание может быть записано посредством [[Qt:Документация 4.3.2/qxmlstreamwriter#writeCharacters | writeCharacters()]], которая также удаляет запрещённые символы и символьные последовательности, [[Qt:Документация 4.3.2/qxmlstreamwriter#writeEntityReference | writeEntityReference()]] , или последующими вызовами к [[Qt:Документация 4.3.2/qxmlstreamwriter#writeStartElement | writeStartElement()]]. | |
- | + | Класс <tt>XbelWriter</tt> из [[Qt:Документация 4.3.2/xml-streambookmarks | QXmlStream Bookmarks Example]] является подклассом [[Qt:Документация 4.3.2/qxmlstreamwriter | QXmlStreamWriter]]. Его функция <tt>writeFile()</tt> представляет базовые функции [[Qt:Документация 4.3.2/qxmlstreamwriter | QXmlStreamWriter]], которые упоминались выше: | |
<source lang="cpp-qt"> bool XbelWriter::writeFile(QIODevice *device) | <source lang="cpp-qt"> bool XbelWriter::writeFile(QIODevice *device) | ||
{ | { | ||
Строка 204: | Строка 223: | ||
writeEndDocument(); | writeEndDocument(); | ||
return true; | return true; | ||
- | }</source> | + | }</source> <div id="the-qt-sax2-classes"></div> |
- | === | + | |
- | ==== | + | ===Классы Qt SAX2=== |
- | + | <div id="introduction-to-sax2"></div> | |
+ | ====Введение в SAX2==== | ||
+ | |||
+ | Интерфейс SAX2 - это механизм основанный на событиях для представления пользователю информации документа. В данном контексте "событие" ("event") это реакция парсера, например, на его встречу с начальным или конечным тегом. | ||
- | + | Для большей конкретики давайте рассмотрим следующий пример: | |
<source lang="cpp-qt"> <quote>A quotation.</quote></source> | <source lang="cpp-qt"> <quote>A quotation.</quote></source> | ||
- | + | В процессе чтения (парсер SAX2 обычно называют читающий парсер ("reader")) представленного выше документа произойдет три события: | |
- | # | + | #Встретится начальный тег (<tt><quote></tt>). |
- | # | + | #Обнаружены символьные данные (т.е. текст), "A quotation.". |
- | # | + | #Обработан конечный тег (<tt></quote></tt>). |
- | + | Каждый раз, когда произойдет одно из событий парсер отреагирует на него. Вы можете установить обработчик событий для их перехвата. | |
- | + | Представленный подход обеспечивает быстрое чтение XML документа, однако его обработка достаточно трудоемка, поскольку данные не сохраняются в памяти. Они последовательно обрабатываются и отбрасываются. [[#dom | Интерфейс DOM]] читает и сохраняет весь документ, представляя его в виде дерева. Этот подход требует больше памяти, но позволяет более легко обрабатывать документ. | |
- | + | Модуль Qt XML включает абстрактный класс, [[Qt:Документация 4.3.2/qxmlreader | QXmlReader]]. Он определяет интерфейс для потенциальной программы чтения согласно SAX2. Qt включает и собственный модуль чтения [[Qt:Документация 4.3.2/qxmlsimplereader | QXmlSimpleReader]], который легко адаптируется посредством подклассов. | |
- | + | Модуль чтения во время синтаксического анализа реагирует на события через специальные классы обработки: | |
{| width="100%" class="annotated" cellpadding="2" cellspacing="1" border="0" | {| width="100%" class="annotated" cellpadding="2" cellspacing="1" border="0" | ||
|- valign="top" class="qt-style" | | |- valign="top" class="qt-style" | | ||
- | ! | + | !Класс обработки |
- | ! | + | !Описание |
|- valign="top" class="odd" | | |- valign="top" class="odd" | | ||
|[[Qt:Документация 4.3.2/qxmlcontenthandler | QXmlContentHandler]] | |[[Qt:Документация 4.3.2/qxmlcontenthandler | QXmlContentHandler]] | ||
- | | | + | |Обрабатывает события, относящиеся к содержанию документа (т.е. начальный тег или символы). |
|- valign="top" class="even" | | |- valign="top" class="even" | | ||
|[[Qt:Документация 4.3.2/qxmldtdhandler | QXmlDTDHandler]] | |[[Qt:Документация 4.3.2/qxmldtdhandler | QXmlDTDHandler]] | ||
- | | | + | |Обрабатывает события, относящиеся к DTD (т.е. объявления нотаций). |
|- valign="top" class="odd" | | |- valign="top" class="odd" | | ||
|[[Qt:Документация 4.3.2/qxmlerrorhandler | QXmlErrorHandler]] | |[[Qt:Документация 4.3.2/qxmlerrorhandler | QXmlErrorHandler]] | ||
- | | | + | |Обрабатывает ошибки или предупреждения, которые имели место во время синтаксического анализа. |
|- valign="top" class="even" | | |- valign="top" class="even" | | ||
|[[Qt:Документация 4.3.2/qxmlentityresolver | QXmlEntityResolver]] | |[[Qt:Документация 4.3.2/qxmlentityresolver | QXmlEntityResolver]] | ||
- | | | + | |Обрабатывает внешние сущности и позволяет пользователям сами разрешать внешние сущности вместо тех, что установил модуль чтения. |
|- valign="top" class="odd" | | |- valign="top" class="odd" | | ||
|[[Qt:Документация 4.3.2/qxmldeclhandler | QXmlDeclHandler]] | |[[Qt:Документация 4.3.2/qxmldeclhandler | QXmlDeclHandler]] | ||
- | | | + | |Обрабатывает иные события, относящиеся к DTD (т.е. объявления атрибутов). |
|- valign="top" class="even" | | |- valign="top" class="even" | | ||
|[[Qt:Документация 4.3.2/qxmllexicalhandler | QXmlLexicalHandler]] | |[[Qt:Документация 4.3.2/qxmllexicalhandler | QXmlLexicalHandler]] | ||
- | | | + | |Обрабатывает события, относящиеся к лексической структуре документа (заголовок DTD, комментарии и т.д.). |
|} | |} | ||
- | + | Данные классы это абстрактные классы описываемого интерфейса. Класс [[Qt:Документация 4.3.2/qxmldefaulthandler | QXmlDefaultHandler]] обеспечивает по умолчанию для всех остальных классов "пустые действия" ("do nothing"). Следовательно пользователям необходимо только перегрузить функции [[Qt:Документация 4.3.2/qxmldefaulthandler | QXmlDefaultHandler]] в зависимости от своих интересов. | |
- | + | Для чтения входных XML данных используется специальный класс [[Qt:Документация 4.3.2/qxmlinputsource | QXmlInputSource]]. | |
- | + | ||
- | + | ||
+ | Следующие классы поддержки SAX2 обеспечивают дополнительную полезную функциональность. Некоторые из них уже упоминались. | ||
{| width="100%" class="annotated" cellpadding="2" cellspacing="1" border="0" | {| width="100%" class="annotated" cellpadding="2" cellspacing="1" border="0" | ||
|- valign="top" class="qt-style" | | |- valign="top" class="qt-style" | | ||
- | ! | + | !Класс |
- | ! | + | !Описание |
|- valign="top" class="odd" | | |- valign="top" class="odd" | | ||
|[[Qt:Документация 4.3.2/qxmlattributes | QXmlAttributes]] | |[[Qt:Документация 4.3.2/qxmlattributes | QXmlAttributes]] | ||
- | | | + | |Используется для передачи атрибутов в событие начального элемента. |
|- valign="top" class="even" | | |- valign="top" class="even" | | ||
|[[Qt:Документация 4.3.2/qxmllocator | QXmlLocator]] | |[[Qt:Документация 4.3.2/qxmllocator | QXmlLocator]] | ||
- | | | + | |Используется для получения реальной позиции обработки события. |
|- valign="top" class="odd" | | |- valign="top" class="odd" | | ||
|[[Qt:Документация 4.3.2/qxmlnamespacesupport | QXmlNamespaceSupport]] | |[[Qt:Документация 4.3.2/qxmlnamespacesupport | QXmlNamespaceSupport]] | ||
- | | | + | |Используется с целью поддержки пространства имен в модуле чтения. Отметим, сто пространства имен не изменяют алгоритм обработки. Они только отображаются в обработчике. |
|} | |} | ||
- | + | [[Qt:Документация 4.3.2/xml-saxbookmarks | Пример SAX Bookmarks]] показывает как в подклассе [[Qt:Документация 4.3.2/qxmldefaulthandler | QXmlDefaultHandler]] выполняется чтение XML bookmark файла (XBEL) и как генерировать XML вручную. | |
+ | <div id="sax2-features"></div> | ||
+ | |||
+ | ====Особенности SAX2==== | ||
- | + | Поведение модуля чтения (reader) XML зависит от того, как он поддерживает ряд необязательных опций. Например, модуль чтения может иметь возможность "выдача атрибутов, используемых для объявления префикса пространства имен и связывания префикса с локальным именем тега". Подобно другим, данная возможность имеет уникальное имя, представленное URI: ''http://xml.org/sax/features/namespace-prefixes''. | |
- | + | ||
- | + | Реализация SAX2 в Qt позволяет определить, может ли модуль чтения иметь не стандартную функциональность . Для этого используется функция [[Qt:Документация 4.3.2/qxmlreader#hasFeature | QXmlReader::hasFeature]](). Доступные особенности могут определяться с помощью [[Qt:Документация 4.3.2/qxmlreader#feature | QXmlReader::feature]](). Их можно включать и отключать используя [[Qt:Документация 4.3.2/qxmlreader#setFeature | QXmlReader::setFeature]](). | |
- | + | Возьмем следующий пример | |
<source lang="cpp-qt"> <document xmlns:book = 'http://trolltech.com/fnord/book/' | <source lang="cpp-qt"> <document xmlns:book = 'http://trolltech.com/fnord/book/' | ||
xmlns = 'http://trolltech.com/fnord/' ></source> | xmlns = 'http://trolltech.com/fnord/' ></source> | ||
- | + | Модуль чтения, который не поддерживает опцию ''http://xml.org/sax/features/namespace-prefixes'' будет выдавать имя элемента ''document'', но без его атрибутов ''xmlns:book'' и ''xmlns'' и их значений. Модуль чтения с поддержкой опции ''http://xml.org/sax/features/namespace-prefixes'' выдаст атрибуты пространства имен, если [[Qt:Документация 4.3.2/qxmlreader#feature | feature]] включен. | |
- | + | Другие особенности включают ''http://xml.org/sax/features/namespace'' (обработка пространства имен, полагая ''http://xml.org/sax/features/namespace-prefixes'') и ''http://xml.org/sax/features/validation'' (способность выдавать ошибки проверки на соответствие схеме). | |
- | + | В том случае, если SAX2 предоставляет возможность пользователю задавать и выполнять требуемые особенности, поддержка ''http://xml.org/sax/features/namespace'' (а также ''http://xml.org/sax/features/namespace-prefixes'') обязательна. Функциональность [[Qt:Документация 4.3.2/qxmlsimplereader | QXmlSimpleReader]] из [[Qt:Документация 4.3.2/qxmlreader | QXmlReader]], поддерживает их, и позволяя обрабатывать пространства имен. | |
- | [[Qt:Документация 4.3.2/qxmlsimplereader | QXmlSimpleReader]] | + | [[Qt:Документация 4.3.2/qxmlsimplereader | QXmlSimpleReader]] не проверяет на соответствие схеме, поскольку он не поддерживает ''http://xml.org/sax/features/validation''. |
+ | <div id="namespace-support-via-features"></div> | ||
- | ==== | + | ====Поддержка пространства имен посредством опций==== |
- | + | ||
- | + | Как показано в предыдущем разделе, мы можем конфигурировать правила работы модуля чтения, когда он получает управление для обработки пространства имен. Это выполняется посредством задания и отключения опций ''http://xml.org/sax/features/namespaces'' и ''http://xml.org/sax/features/namespace-prefixes''. | |
- | + | Они влияют на алгоритм поведения в следующих случаях: | |
- | + | ||
- | + | ||
- | + | ||
- | + | #При отображении префиксов пространств имен и локальных частей элементов и атрибутов. | |
+ | #При отображении квалификационных имен элементов и атрибутов. | ||
+ | #При вызове модулем чтения [[Qt:Документация 4.3.2/qxmlcontenthandler#startPrefixMapping | QXmlContentHandler::startPrefixMapping]]() и [[Qt:Документация 4.3.2/qxmlcontenthandler#endPrefixMapping | QXmlContentHandler::endPrefixMapping]](). | ||
+ | #При отображении атрибутов, которые объявляют пространства имен (т.е. атрибута ''xmlns'' и атрибутов, начинающиеся с ''xmlns:''). | ||
+ | |||
+ | Возьмем следующий элемент: | ||
<source lang="cpp-qt"> <author xmlns:fnord = 'http://trolltech.com/fnord/' | <source lang="cpp-qt"> <author xmlns:fnord = 'http://trolltech.com/fnord/' | ||
title="Ms" | title="Ms" | ||
fnord:title="Goddess" | fnord:title="Goddess" | ||
name="Eris Kallisti"/></source> | name="Eris Kallisti"/></source> | ||
- | + | Если установить ''http://xml.org/sax/features/namespace-prefixes'' в true, то модуль чтения будет отображать четыре атирибута; но установив опцию ''namespace-prefixes'' в false только три. Атрибут ''xmlns:fnord'', определяющий пространство имен "невидим" для модуля чтения. | |
- | + | Опция ''http://xml.org/sax/features/namespaces'' отвечает за видимость локальных имен, префиксов пространства имен и URI. В случае установки ''http://xml.org/sax/features/namespaces'' в true, парсер отобразит ''title'' как локальное имя атрибута ''fnord:title'', ''fnord'' как префикс пространства имен и ''http://trolltech.com/fnord/'' как URI пространства имен. Когда ''http://xml.org/sax/features/namespaces'' установлен в false они не будут отображаться. | |
- | + | В текущей версии классов Qt XML определено, что префикс ''xmlns'' самостоятельно не сопоставляется ни с каким пространством имен (см. [http://www.w3.org/TR/1999/REC-xml-names-19990114/#ns-using http://www.w3.org/TR/1999/REC-xml-names-19990114/#ns-using]). Следовательно, даже если и ''http://xml.org/sax/features/namespaces'' и ''http://xml.org/sax/features/namespace-prefixes'' установлены в true, модуль чтения не сможет вернуть ни локальное именя, ни префикс пространства имен, ни URI пространства имен для ''xmlns:fnord''. | |
- | + | Возможно это изменится в будущем, когда W3C даст указание [http://www.w3.org/2000/xmlns/ http://www.w3.org/2000/xmlns/] связывать ''xmlns'' с пространством имен ''http://www.w3.org/2000/xmlns''. | |
- | + | Стандарт SAX2 предлагает, значение по умолчанию для [[Qt:Документация 4.3.2/qxmlsimplereader | QXmlSimpleReader]] ''http://xml.org/sax/features/namespaces'' установлено в true, а для ''http://xml.org/sax/features/namespace-prefixes'' в false. Отметим, что комбинация [[Qt:Документация 4.3.2/qxmlsimplereader#setFeature | QXmlSimpleReader::setFeature]](), связанная с установлением обеих опций в false является незаконной. | |
+ | <div id="summary"></div> | ||
+ | =====Заключение===== | ||
- | + | [[Qt:Документация 4.3.2/qxmlsimplereader | QXmlSimpleReader]] поддерживает следующие правила: | |
- | [[Qt:Документация 4.3.2/qxmlsimplereader | QXmlSimpleReader]] | + | |
Строка 322: | Строка 348: | ||
|- valign="top" class="qt-style" | | |- valign="top" class="qt-style" | | ||
!(namespaces, namespace-prefixes) | !(namespaces, namespace-prefixes) | ||
- | ! | + | !Префикс пространства имен и локальная часть |
- | ! | + | !Квалифицированные имена |
- | ! | + | !Отображение префикса |
- | !xmlns | + | !Атрибуты xmlns |
|- valign="top" class="odd" | | |- valign="top" class="odd" | | ||
|(true, false) | |(true, false) | ||
Строка 349: | Строка 375: | ||
|} | |} | ||
- | + | Поведение записей, отмеченных звездочкой (*) не определено в SAX. | |
+ | <div id="properties"></div> | ||
====Свойства==== | ====Свойства==== | ||
+ | |||
Свойства are a more general concept. They have a unique name, represented as an URI, but their value is <tt>void*</tt>. Thus nearly anything can be used as a property value. This concept involves some danger, though: there is no means of ensuring type-safety; the user must take care that they pass the right type. Свойства are useful if a reader supports special handler classes. | Свойства are a more general concept. They have a unique name, represented as an URI, but their value is <tt>void*</tt>. Thus nearly anything can be used as a property value. This concept involves some danger, though: there is no means of ensuring type-safety; the user must take care that they pass the right type. Свойства are useful if a reader supports special handler classes. | ||
Строка 359: | Строка 387: | ||
To set or query properties the following functions are provided: [[Qt:Документация 4.3.2/qxmlreader#setProperty | QXmlReader::setProperty]](), [[Qt:Документация 4.3.2/qxmlreader#property | QXmlReader::property]]() and [[Qt:Документация 4.3.2/qxmlreader#hasProperty | QXmlReader::hasProperty]](). | To set or query properties the following functions are provided: [[Qt:Документация 4.3.2/qxmlreader#setProperty | QXmlReader::setProperty]](), [[Qt:Документация 4.3.2/qxmlreader#property | QXmlReader::property]]() and [[Qt:Документация 4.3.2/qxmlreader#hasProperty | QXmlReader::hasProperty]](). | ||
+ | <div id="dom"></div><div id="the-qt-dom-classes"></div> | ||
- | === | + | ===Классы Qt DOM=== |
- | ==== | + | <div id="domintro"></div><div id="introduction-to-dom"></div> |
- | + | ====Введение в DOM==== | |
- | + | DOM представляет интерфейс для доступа или изменения содержания и структуры XML файла. Он формирует иерархическое представление документа (представление в виде дерева). В противоположность интерфейсу SAX2 , объектная модель документа после синтаксического анализа располагается в памяти, что позволяет легко ей манипулировать. | |
- | + | Все узлы DOM в дереве документа являются подклассами [[Qt:Документация 4.3.2/qdomnode | QDomNode]]. Сам документ представляется как объект [[Qt:Документация 4.3.2/qdomdocument | QDomDocument]]. | |
- | *[[Qt:Документация 4.3.2/qdomdocument | QDomDocument]]: | + | Ниже представлены доступные классы узлов и указано - есть ли у них дочерние классы: |
- | **[[Qt:Документация 4.3.2/qdomelement | QDomElement]] ( | + | |
+ | *[[Qt:Документация 4.3.2/qdomdocument | QDomDocument]]: возможны дочерние классы | ||
+ | **[[Qt:Документация 4.3.2/qdomelement | QDomElement]] (максимум один) | ||
**[[Qt:Документация 4.3.2/qdomprocessinginstruction | QDomProcessingInstruction]] | **[[Qt:Документация 4.3.2/qdomprocessinginstruction | QDomProcessingInstruction]] | ||
**[[Qt:Документация 4.3.2/qdomcomment | QDomComment]] | **[[Qt:Документация 4.3.2/qdomcomment | QDomComment]] | ||
**[[Qt:Документация 4.3.2/qdomdocumenttype | QDomDocumentType]] | **[[Qt:Документация 4.3.2/qdomdocumenttype | QDomDocumentType]] | ||
- | *[[Qt:Документация 4.3.2/qdomdocumentfragment | QDomDocumentFragment]]: | + | *[[Qt:Документация 4.3.2/qdomdocumentfragment | QDomDocumentFragment]]: возможны дочерние классы |
**[[Qt:Документация 4.3.2/qdomelement | QDomElement]] | **[[Qt:Документация 4.3.2/qdomelement | QDomElement]] | ||
**[[Qt:Документация 4.3.2/qdomprocessinginstruction | QDomProcessingInstruction]] | **[[Qt:Документация 4.3.2/qdomprocessinginstruction | QDomProcessingInstruction]] | ||
Строка 382: | Строка 413: | ||
**[[Qt:Документация 4.3.2/qdomentityreference | QDomEntityReference]] | **[[Qt:Документация 4.3.2/qdomentityreference | QDomEntityReference]] | ||
- | *[[Qt:Документация 4.3.2/qdomdocumenttype | QDomDocumentType]]: | + | *[[Qt:Документация 4.3.2/qdomdocumenttype | QDomDocumentType]]: нет дочерних классов |
- | *[[Qt:Документация 4.3.2/qdomentityreference | QDomEntityReference]]: | + | *[[Qt:Документация 4.3.2/qdomentityreference | QDomEntityReference]]: возможны дочерние классы |
**[[Qt:Документация 4.3.2/qdomelement | QDomElement]] | **[[Qt:Документация 4.3.2/qdomelement | QDomElement]] | ||
**[[Qt:Документация 4.3.2/qdomprocessinginstruction | QDomProcessingInstruction]] | **[[Qt:Документация 4.3.2/qdomprocessinginstruction | QDomProcessingInstruction]] | ||
Строка 391: | Строка 422: | ||
**[[Qt:Документация 4.3.2/qdomentityreference | QDomEntityReference]] | **[[Qt:Документация 4.3.2/qdomentityreference | QDomEntityReference]] | ||
- | *[[Qt:Документация 4.3.2/qdomelement | QDomElement]]: | + | *[[Qt:Документация 4.3.2/qdomelement | QDomElement]]: возможны дочерние классы |
**[[Qt:Документация 4.3.2/qdomelement | QDomElement]] | **[[Qt:Документация 4.3.2/qdomelement | QDomElement]] | ||
**[[Qt:Документация 4.3.2/qdomtext | QDomText]] | **[[Qt:Документация 4.3.2/qdomtext | QDomText]] | ||
Строка 399: | Строка 430: | ||
**[[Qt:Документация 4.3.2/qdomentityreference | QDomEntityReference]] | **[[Qt:Документация 4.3.2/qdomentityreference | QDomEntityReference]] | ||
- | *[[Qt:Документация 4.3.2/qdomattr | QDomAttr]]: | + | *[[Qt:Документация 4.3.2/qdomattr | QDomAttr]]: возможны дочерние классы |
**[[Qt:Документация 4.3.2/qdomtext | QDomText]] | **[[Qt:Документация 4.3.2/qdomtext | QDomText]] | ||
**[[Qt:Документация 4.3.2/qdomentityreference | QDomEntityReference]] | **[[Qt:Документация 4.3.2/qdomentityreference | QDomEntityReference]] | ||
- | *[[Qt:Документация 4.3.2/qdomprocessinginstruction | QDomProcessingInstruction]]: | + | *[[Qt:Документация 4.3.2/qdomprocessinginstruction | QDomProcessingInstruction]]: нет дочерних классов |
- | *[[Qt:Документация 4.3.2/qdomcomment | QDomComment]]: | + | *[[Qt:Документация 4.3.2/qdomcomment | QDomComment]]: возможны дочерние классы |
- | *[[Qt:Документация 4.3.2/qdomtext | QDomText]]: | + | *[[Qt:Документация 4.3.2/qdomtext | QDomText]]: нет дочерних классов |
- | *[[Qt:Документация 4.3.2/qdomcdatasection | QDomCDATASection]]: | + | *[[Qt:Документация 4.3.2/qdomcdatasection | QDomCDATASection]]: нет дочерних классов |
- | *[[Qt:Документация 4.3.2/qdomentity | QDomEntity]]: | + | *[[Qt:Документация 4.3.2/qdomentity | QDomEntity]]: возможны дочерние классы |
**[[Qt:Документация 4.3.2/qdomelement | QDomElement]] | **[[Qt:Документация 4.3.2/qdomelement | QDomElement]] | ||
**[[Qt:Документация 4.3.2/qdomprocessinginstruction | QDomProcessingInstruction]] | **[[Qt:Документация 4.3.2/qdomprocessinginstruction | QDomProcessingInstruction]] | ||
Строка 415: | Строка 446: | ||
**[[Qt:Документация 4.3.2/qdomentityreference | QDomEntityReference]] | **[[Qt:Документация 4.3.2/qdomentityreference | QDomEntityReference]] | ||
- | *[[Qt:Документация 4.3.2/qdomnotation | QDomNotation]]: | + | *[[Qt:Документация 4.3.2/qdomnotation | QDomNotation]]: нет дочерних классов |
- | + | [[Qt:Документация 4.3.2/qdomnodelist | QDomNodeList]] и [[Qt:Документация 4.3.2/qdomnamednodemap | QDomNamedNodeMap]] - две коллекции классов, которые обеспечивают: [[Qt:Документация 4.3.2/qdomnodelist | QDomNodeList]] - список узлов, а [[Qt:Документация 4.3.2/qdomnamednodemap | QDomNamedNodeMap]] обработку неупорядоченного набора узлов (часто используется для атрибутов). | |
- | + | Класс [[Qt:Документация 4.3.2/qdomimplementation | QDomImplementation]] позволяет пользователю запрашивать особенности обработки DOM. | |
- | + | Прежде чем начать работать пожалуйста посмотрите документацию [[Qt:Документация 4.3.2/qdomdocument | QDomDocument]]. Вы также можете захотеть посмотреть [[Qt:Документация 4.3.2/xml-dombookmarks | пример DOM Bookmarks]], который иллюстрирует применение DOM для чтения и записи закладок XML файла (XBEL). | |
+ | <div id="namespaces"></div><div id="an-introduction-to-namespaces"></div> | ||
- | === | + | ===Введение в пространство имен (NameSpace)=== |
- | + | ||
- | + | Часть разделов документации Qt XML module предполагает, что вы знакомы с пространством имен XML. Здесь мы даем краткое введение. Если вы знакомы с [[#namespacesconventions | Qt XML documentation conventions]], то можете пропустить данный материал. | |
- | + | Пространство имен - это концепция, введенная в XML, чтобы позволить осуществлять более модульное проектирование. С его помощью во время программной обработки данных можно легко разрешить конфликты именования имен в XML документах. | |
+ | |||
+ | Рассмотрим следующий пример: | ||
<source lang="cpp-qt"> <document> | <source lang="cpp-qt"> <document> | ||
<book> | <book> | ||
Строка 438: | Строка 471: | ||
</book> | </book> | ||
</document></source> | </document></source> | ||
- | + | Здесь можно увидеть три различных использования имени ''title''. Если вы захотите обработать данный документ, то у вас появятся проблемы, поскольку каждый из ''titles'' должен представляться в разной манере, несмотря на то, что используется одно и тоже имя. | |
- | + | Решение должно основываться на неком способе, позволяющем идентифицировать первый ''title'' как название книги, т.е. использовать элемент ''title'' в пространстве имен книги для отличия его, например, от названия раздела: | |
<source lang="cpp-qt"> <book:title>Practical XML</book:title></source> | <source lang="cpp-qt"> <book:title>Practical XML</book:title></source> | ||
- | ''book'' | + | В данном случае ''book'' является ''префиксом'', указывающим на пространство имен. |
- | + | До того, как применять пространство имен для элементов и атрибутов, необходимо его объявить. | |
- | + | Пространство имен подобно URI: ''http://trolltech.com/fnord/book/''. Данное URI не указывает, что по этому адресу должны быть доступны данные. URI просто используется для задания уникального имени. | |
- | + | Мы указываем пространства имен точно также как и атрибуты. Строго говоря они и ''есть'' атрибуты. Для того, чтобы объявить пространство имен документа ''http://trolltech.com/fnord/'' как пространство имен по умолчанию, мы должны написать | |
<source lang="cpp-qt"> xmlns="http://trolltech.com/fnord/"</source> | <source lang="cpp-qt"> xmlns="http://trolltech.com/fnord/"</source> | ||
- | + | Чтобы отличить пространство имен ''http://trolltech.com/fnord/book/'' от пространства имен по умолчанию, мы должны использовать префикс: | |
<source lang="cpp-qt"> xmlns:book="http://trolltech.com/fnord/book/"</source> | <source lang="cpp-qt"> xmlns:book="http://trolltech.com/fnord/book/"</source> | ||
- | + | Пространство имен, объявленное таким образом, может быть добавлено к именам элементов и атрибутов посредством префикса и разделителя ":". Мы уже видели это у элемента ''book:title''. | |
- | + | Имена элементов без префикса принадлежат пространству имен по умолчанию. Данное правило не распространяется на атрибуты. Атрибут без префикса вообще не принадлежит никакому объявленному пространству имен XML. Атрибуты всегда принадлежат к "традиционному" пространству имен элемента, с которым они применяются. "Традиционное" пространства имен это не пространства имен XML. Просто предполагается, что все имена атрибутов, принадлежащие одному элементу, должны быть разными. Далее мы увидим как назначается пространство имен XML для атрибута. | |
- | + | Фактически атрибуты без префикса не принадлежат никакому пространству имен XML, при этом нет коллизии между атрибутом ''title'' (который принадлежит элементу ''author'') и, например, элементом ''title'' в контейнере ''chapter''. | |
- | + | Давайте проясним это на примере: | |
<source lang="cpp-qt"> <document xmlns:book = 'http://trolltech.com/fnord/book/' | <source lang="cpp-qt"> <document xmlns:book = 'http://trolltech.com/fnord/book/' | ||
xmlns = 'http://trolltech.com/fnord/' > | xmlns = 'http://trolltech.com/fnord/' > | ||
Строка 472: | Строка 505: | ||
</book> | </book> | ||
</document></source> | </document></source> | ||
- | + | В элементе ''document'' мы имеем два объявления пространства имен. Пространство имен по умолчанию ''http://trolltech.com/fnord/'' применяется к элементу ''book'', элементу ''chapter'', соответствующему элементу ''title'' и, конечно, к самому элементу ''document''. | |
- | + | Элементы ''book:author'' и ''book:title'' принадлежат пространству имен, идентифицируемому URI ''http://trolltech.com/fnord/book/''. | |
- | + | Двум атрибутам ''title'' и ''name'' элемента ''book:author'' не назначено пространство имен XML. Они являются членами "традиционного" пространства имен элемента ''book:author''. Это означает, что, например, два атрибута ''title'' в ''book:author'' недопустимо. | |
- | + | Выше в примере мы обошли данное правило. Мы объявили пространство имен ''http://trolltech.com/fnord/'' с префиксом ''fnord'' в элементе ''book:author'' и добавили этот префикс к атрибуту ''title'' элемента ''book:author''. | |
- | + | Очевидно, пространство имен ''fnord'' имеет точно такое же URI, что и пространство имен по умолчанию. Почему же мы просто не использовали ранее объявленное пространство имен по умолчанию? Ответ не совсем простой: | |
- | * | + | *атрибуты без префикса вообще не принадлежат никакому пространству имен, даже пространству имен по умолчанию; |
- | * | + | *пренебрежение префиксом будет приводить к конфликту типа ''title-title''; |
- | * | + | *запись префикса как ''xmlns:title'' позволит объявить новое пространство имен с префиксом ''title'' вместо используемого пространства имен по умолчанию ''xmlns''. |
- | + | Используя классы Qt XML доступ к элементам и атрибутам может осуществляться двумя способами: либо ссылаясь на их квалифицированные имена, включающие префикс пространства имен и "реальное" имя (или "локальное" имя), либо используя комбинацию локального имени и URI пространства имен. | |
- | + | ||
- | + | ||
+ | Дополнительную информацию о пространстве имен XML можно найти на [http://www.w3.org/TR/REC-xml-names/ http://www.w3.org/TR/REC-xml-names/]. | ||
+ | <div id="namespacesconventions"></div><div id="conventions-used-in-the-qt-xml-documentation"></div> | ||
====Conventions Used in the Qt XML Documentation==== | ====Conventions Used in the Qt XML Documentation==== | ||
- | |||
- | * | + | Следующие термины используются для различия частей имен в контексте пространства имен: |
- | * | + | |
- | * | + | *''квалифицированное имя'' (''qualified name'') - это имя как оно представляется в документе. (В примерах, представленных выше, ''book:title'' это квалифицированное имя.) |
- | * | + | *''префикс пространства имен'' (''namespace prefix'') - часть квалифицированного имени слева от ":". (''book'' - это префикс пространства имен в ''book:title''.) |
+ | *''локальная часть'' (''local part'') - часть квалифицированного имени справа от ":" (иногда ее называют ''локальное имя'' (''local name'')). (''title'' - локальная часть часть ''book:title''.) | ||
+ | *''пространство имен URI'' (''namespace URI'' ("Uniform Resource Identifier")) - это уникальный идентификатор пространства имен. Внешне он выглядит подобно URL (например, ''http://trolltech.com/fnord/'' ), но не требует, чтобы по этому адресу были доступны какие-либо данные. | ||
- | + | Элементы без ":" (в примере подобно ''chapter'') не имеют префикса пространства имен. В этом случае локальная часть и квалифицированное имя идентичны (например, ''chapter''). | |
- | + | Также смотрите [[Qt:Документация 4.3.2/xml-dombookmarks | DOM Bookmarks Example]] и [[Qt:Документация 4.3.2/xml-saxbookmarks | SAX Bookmarks Example]]. | |
- | [Previous: [[Qt:Документация 4.3.2/qtsvg | QtSvg Module]]] [ [[Qt:Документация 4.3.2/modules | Qt's Modules]] ] [Next: [[Qt:Документация 4.3.2/qtdesigner | QtDesigner Module]]] | + | [Previous: [[Qt:Документация 4.3.2/qtsvg | QtSvg Module]] ] [ [[Qt:Документация 4.3.2/modules | Qt's Modules]] ] [Next: [[Qt:Документация 4.3.2/qtdesigner | QtDesigner Module]] ] |
{{Qt4.3.2_footer}} | {{Qt4.3.2_footer}} |
Текущая версия на 17:35, 18 января 2009
Внимание: Актуальная версия перевода документации находится здесь |
__NOTOC__
Главная · Все классы · Основные классы · Классы по группам · Модули · Функции |
[Предыдущая: Модуль QtScript ] [ Модули Qt ] [Следующая: Модуль QtDesigner ]
Содержание |
[править] Модуль QtXml
Модуль QtXml обеспечивает работу с потоками чтения и записи XML документов и реализацию их в форме SAX и DOM. Далее...
[править] Классы
QDomAttr | Представляет один атрибут QDomElement |
---|---|
QDomCDATASection | Представляет в XML область CDATA |
QDomCharacterData | Представляет общие строки в DOM |
QDomComment | Представляет XML комментарий |
QDomDocument | Представляет XML документ |
QDomDocumentFragment | Дерево из QDomNodes, которое, как правило, не является целым QDomDocument |
QDomDocumentType | Представление о DTD в дереве документа |
QDomElement | Представляет один элемент в DOM дереве |
QDomEntity | Представляет XML сущность |
QDomEntityReference | Представляет ссылку на XML сущность |
QDomImplementation | Информация о возможностях представления DOM |
QDomNamedNodeMap | Коллекция узлов, которые могут быть доступны по имени |
QDomNode | Базовый класс для всех узлов в DOM дереве |
QDomNodeList | Список объектов QDomNode |
QDomNotation | Представление XML нотации |
QDomProcessingInstruction | Представление инструкций обработки XML |
QDomText | Представляет текстовые данные в разбираемом XML документе |
QXmlAttributes | XML атрибуты |
QXmlContentHandler | Интрефейс для описания логического содержания XML данных |
QXmlDTDHandler | Интерфейс для описания DTD, содержащимся в XML данных |
QXmlDeclHandler | Интерфейс для описания декларации содержимого XML данных |
QXmlDefaultHandler | Представление по-умолчанию всех классов XML-обработчиков |
QXmlEntityResolver | Интерфейс для разбора внешних сущностей, содержащихся в XML-данных |
QXmlErrorHandler | Интерфейс для сообщений об ошибках в XML-данных |
QXmlInputSource | Входящие данные для подклассов QXmlReader |
QXmlLexicalHandler | Интерфейс для сообщений о лексическом содержании XML-данных |
QXmlLocator | Обработчик XML классов с информацией о позиции разбора в файле |
QXmlNamespaceSupport | Вспомогательный класс для чтения XML с поддержкой пространств имен |
QXmlParseException | Используется для сообщений об ошибках с интерфейсом QXmlErrorHandler |
QXmlReader | Интерфейс для чтения XML (т.е. анализаторов) |
QXmlSimpleReader | Реализация простого XML анализатора |
QXmlStreamAttribute | Представление одиночного XML атрибута |
QXmlStreamAttributes | Представление вектора QXmlStreamAttribute |
QXmlStreamEntityDeclaration | Представление декларации DTD сущностей |
QXmlStreamNamespaceDeclaration | Представление декларации пространств имен |
QXmlStreamNotationDeclaration | Представление декларации DTD нотации |
QXmlStreamReader | Быстро и корректно сформированный XML-анализатор с простым потоковым API |
QXmlStreamWriter | Запись XML с простым потоковым API |
[править] Подробное описание
SAX это стандартный, основанный на событиях интерфейс для XML парсеров. Qt интерфейс соответствует возможностям SAX2 Java. Его схема именования была адаптирована согласно соглашений именования, принятых в Qt. Подробное описание SAX2 может быть найдено на http://www.saxproject.org.
Поддержка для фильтров SAX2 и reader factory находятся в стадии разработки. Данная версия Qt не обеспечивает совместимости с классами SAX1, представленными в Java интерфейсе. Введение в классы Qt SAX2 смотрите на Классы Qt SAX2.
DOM Level 2 это W3C Recommendation для XML интерфейсов, которые отображают содержание XML документа в виде дерева. Спецификация DOM Level 2 может быть найдена на http://www.w3.org/DOM/. Дополнительную информацию о классах DOM в Qt представлена в Классы Qt DOM.
Начиная с версии 4.3, Qt ввела два новых класса для чтения и записи XML: QXmlStreamReader и QXmlStreamWriter.
Дополнительно возможности XML обеспечивают QSvgRenderer чтение поднабора SVG. Также развитие XML осуществляется группой Qt Solutions, которая разрабатывает, например, классы для поддержки SOAP и MML на основе классов Qt XML.
Для подключения модуля с классами нужно использовать следующую директиву:
#include <QtXml>
Чтобы соединиться с модулем добавьте данную строку в ваш qmake .pro файл:
QT += xml
Данный модуль это часть Qt Console Edition, Qt Desktop Edition и Qt Open Source Edition.
Разделы:
- Конфигурирование процесса сборки
- Классы потока QtXml
- Классы Qt SAX2
- Классы Qt DOM
- Введение в пространство имен
[править] Конфигурирование процесса сборки
Приложения, использующие классы Qt XML, должны быть собраны вместе с модулем QtXml. Следующее объявление в qmake файла проекта гарантирует, что приложение скомпилируется и отредактируется (linked) соответствующим образом:
QT += xml
Данная строка необходима, поскольку только модули QtCore и QtGui используются по умолчанию в процессе сборки.
[править] Классы потока QtXml
QXmlStreamReader и QXmlStreamWriter это два новых класса, появившихся начиная с версии Qt 4.3. Потоковый модуль чтения представляет XML документ как поток токенов (tokens). Это отличие от SAX, т.к. SAX приложения обеспечивают обработку поступающих событий XML от парсера, тогда как QXmlStreamReader передача осуществляется циклически, втягивая токены из модуля чтения, когда они требуются. Данный подход, основанный на втягивании, предоставляет возможность строить парсеры с рекурсивной обработкой, позволяя разделить код, выполняющий синтаксический анализ XML, на различные методы и классы.
QXmlStreamReader это парсеры, обеспечивающие обработку правильных (well-formed) XML документов, за исключением внешних сущностей. Следовательно, данные обрабатываемые потоковым модулем чтения удовлетворяют критерию W3C для правильных (well-formed) XML, что позволит избежать ошибок. С другой стороны, такие функции как atEnd(), error() и hasError() могут быть использованы для проверки и отображения ошибок.
Примером использования QXmlStreamReader может быть XbelReader в QXmlStream Bookmarks Example, который является подклассом QXmlStreamReder. Конструктор принимает treeWidget в качестве параметра и класс получает доступ к специфическим функциям Xbel:
XbelReader(QTreeWidget *treeWidget); ... void readUnknownElement(); void readXBEL(); void readTitle(QTreeWidgetItem *item); void readSeparator(QTreeWidgetItem *item); void readFolder(QTreeWidgetItem *item); void readBookmark(QTreeWidgetItem *item); QTreeWidgetItem *createChildItem(QTreeWidgetItem *item); QTreeWidget *treeWidget; ...
Функция read() принимает QIODevice и пердает его в setDevice(). Функция raiseError() используется для отображения пользовательских сообщений об ошибках, показывая, что версия файла некорректна.
bool XbelReader::read(QIODevice *device) { setDevice(device); while (!atEnd()) { readNext(); if (isStartElement()) { if (name() == "xbel" && attributes().value("version") == "1.0") readXBEL(); else raiseError(QObject::tr("Файл не является файлом XBEL версии 1.0.")); } } return !error(); }
Дополнением к QXmlStreamReader является QXmlStreamWriter. Он представляет собой модуль записи XML с простым потоковым API. QXmlStreamWriter функционирует на основе QIODevice. Он включает специальные функции для токенов или событий XML, которые вы хотите записать. Это writeDTD(), writeCharacters(), writeComment() и т.д.
Для того, чтобы записать XML документ с помощью QXmlStreamWriter, документ должен начинаться с функции writeStartDocument() и заканчиваться функцией writeEndDocument(), которая закроет все оставшиеся открытые теги. Теги элементов открываются writeStartDocument(), далее следуют writeAttribute() или writeAttributes(), содержание элемента и в конце writeEndDocument(). Для записи пустого элемента может быть использован writeEmptyElement().
Содержание элемента представляет собой набор символов, ссылки на сущности или вложенные элементы. Содержание может быть записано посредством writeCharacters(), которая также удаляет запрещённые символы и символьные последовательности, writeEntityReference() , или последующими вызовами к writeStartElement().
Класс XbelWriter из QXmlStream Bookmarks Example является подклассом QXmlStreamWriter. Его функция writeFile() представляет базовые функции QXmlStreamWriter, которые упоминались выше:
bool XbelWriter::writeFile(QIODevice *device) { setDevice(device); writeStartDocument(); writeDTD("<!DOCTYPE xbel>"); writeStartElement("xbel"); writeAttribute("version", "1.0"); for (int i = 0; i < treeWidget->topLevelItemCount(); ++i) writeItem(treeWidget->topLevelItem(i)); writeEndDocument(); return true; }
[править] Классы Qt SAX2
[править] Введение в SAX2
Интерфейс SAX2 - это механизм основанный на событиях для представления пользователю информации документа. В данном контексте "событие" ("event") это реакция парсера, например, на его встречу с начальным или конечным тегом.
Для большей конкретики давайте рассмотрим следующий пример:
<quote>A quotation.</quote>
В процессе чтения (парсер SAX2 обычно называют читающий парсер ("reader")) представленного выше документа произойдет три события:
- Встретится начальный тег (<quote>).
- Обнаружены символьные данные (т.е. текст), "A quotation.".
- Обработан конечный тег (</quote>).
Каждый раз, когда произойдет одно из событий парсер отреагирует на него. Вы можете установить обработчик событий для их перехвата.
Представленный подход обеспечивает быстрое чтение XML документа, однако его обработка достаточно трудоемка, поскольку данные не сохраняются в памяти. Они последовательно обрабатываются и отбрасываются. Интерфейс DOM читает и сохраняет весь документ, представляя его в виде дерева. Этот подход требует больше памяти, но позволяет более легко обрабатывать документ.
Модуль Qt XML включает абстрактный класс, QXmlReader. Он определяет интерфейс для потенциальной программы чтения согласно SAX2. Qt включает и собственный модуль чтения QXmlSimpleReader, который легко адаптируется посредством подклассов.
Модуль чтения во время синтаксического анализа реагирует на события через специальные классы обработки:
Класс обработки | Описание |
---|---|
QXmlContentHandler | Обрабатывает события, относящиеся к содержанию документа (т.е. начальный тег или символы). |
QXmlDTDHandler | Обрабатывает события, относящиеся к DTD (т.е. объявления нотаций). |
QXmlErrorHandler | Обрабатывает ошибки или предупреждения, которые имели место во время синтаксического анализа. |
QXmlEntityResolver | Обрабатывает внешние сущности и позволяет пользователям сами разрешать внешние сущности вместо тех, что установил модуль чтения. |
QXmlDeclHandler | Обрабатывает иные события, относящиеся к DTD (т.е. объявления атрибутов). |
QXmlLexicalHandler | Обрабатывает события, относящиеся к лексической структуре документа (заголовок DTD, комментарии и т.д.). |
Данные классы это абстрактные классы описываемого интерфейса. Класс QXmlDefaultHandler обеспечивает по умолчанию для всех остальных классов "пустые действия" ("do nothing"). Следовательно пользователям необходимо только перегрузить функции QXmlDefaultHandler в зависимости от своих интересов.
Для чтения входных XML данных используется специальный класс QXmlInputSource.
Следующие классы поддержки SAX2 обеспечивают дополнительную полезную функциональность. Некоторые из них уже упоминались.
Класс | Описание |
---|---|
QXmlAttributes | Используется для передачи атрибутов в событие начального элемента. |
QXmlLocator | Используется для получения реальной позиции обработки события. |
QXmlNamespaceSupport | Используется с целью поддержки пространства имен в модуле чтения. Отметим, сто пространства имен не изменяют алгоритм обработки. Они только отображаются в обработчике. |
Пример SAX Bookmarks показывает как в подклассе QXmlDefaultHandler выполняется чтение XML bookmark файла (XBEL) и как генерировать XML вручную.
[править] Особенности SAX2
Поведение модуля чтения (reader) XML зависит от того, как он поддерживает ряд необязательных опций. Например, модуль чтения может иметь возможность "выдача атрибутов, используемых для объявления префикса пространства имен и связывания префикса с локальным именем тега". Подобно другим, данная возможность имеет уникальное имя, представленное URI: http://xml.org/sax/features/namespace-prefixes.
Реализация SAX2 в Qt позволяет определить, может ли модуль чтения иметь не стандартную функциональность . Для этого используется функция QXmlReader::hasFeature(). Доступные особенности могут определяться с помощью QXmlReader::feature(). Их можно включать и отключать используя QXmlReader::setFeature().
Возьмем следующий пример
<document xmlns:book = 'http://trolltech.com/fnord/book/' xmlns = 'http://trolltech.com/fnord/' >
Модуль чтения, который не поддерживает опцию http://xml.org/sax/features/namespace-prefixes будет выдавать имя элемента document, но без его атрибутов xmlns:book и xmlns и их значений. Модуль чтения с поддержкой опции http://xml.org/sax/features/namespace-prefixes выдаст атрибуты пространства имен, если feature включен.
Другие особенности включают http://xml.org/sax/features/namespace (обработка пространства имен, полагая http://xml.org/sax/features/namespace-prefixes) и http://xml.org/sax/features/validation (способность выдавать ошибки проверки на соответствие схеме).
В том случае, если SAX2 предоставляет возможность пользователю задавать и выполнять требуемые особенности, поддержка http://xml.org/sax/features/namespace (а также http://xml.org/sax/features/namespace-prefixes) обязательна. Функциональность QXmlSimpleReader из QXmlReader, поддерживает их, и позволяя обрабатывать пространства имен.
QXmlSimpleReader не проверяет на соответствие схеме, поскольку он не поддерживает http://xml.org/sax/features/validation.
[править] Поддержка пространства имен посредством опций
Как показано в предыдущем разделе, мы можем конфигурировать правила работы модуля чтения, когда он получает управление для обработки пространства имен. Это выполняется посредством задания и отключения опций http://xml.org/sax/features/namespaces и http://xml.org/sax/features/namespace-prefixes.
Они влияют на алгоритм поведения в следующих случаях:
- При отображении префиксов пространств имен и локальных частей элементов и атрибутов.
- При отображении квалификационных имен элементов и атрибутов.
- При вызове модулем чтения QXmlContentHandler::startPrefixMapping() и QXmlContentHandler::endPrefixMapping().
- При отображении атрибутов, которые объявляют пространства имен (т.е. атрибута xmlns и атрибутов, начинающиеся с xmlns:).
Возьмем следующий элемент:
<author xmlns:fnord = 'http://trolltech.com/fnord/' title="Ms" fnord:title="Goddess" name="Eris Kallisti"/>
Если установить http://xml.org/sax/features/namespace-prefixes в true, то модуль чтения будет отображать четыре атирибута; но установив опцию namespace-prefixes в false только три. Атрибут xmlns:fnord, определяющий пространство имен "невидим" для модуля чтения.
Опция http://xml.org/sax/features/namespaces отвечает за видимость локальных имен, префиксов пространства имен и URI. В случае установки http://xml.org/sax/features/namespaces в true, парсер отобразит title как локальное имя атрибута fnord:title, fnord как префикс пространства имен и http://trolltech.com/fnord/ как URI пространства имен. Когда http://xml.org/sax/features/namespaces установлен в false они не будут отображаться.
В текущей версии классов Qt XML определено, что префикс xmlns самостоятельно не сопоставляется ни с каким пространством имен (см. http://www.w3.org/TR/1999/REC-xml-names-19990114/#ns-using). Следовательно, даже если и http://xml.org/sax/features/namespaces и http://xml.org/sax/features/namespace-prefixes установлены в true, модуль чтения не сможет вернуть ни локальное именя, ни префикс пространства имен, ни URI пространства имен для xmlns:fnord.
Возможно это изменится в будущем, когда W3C даст указание http://www.w3.org/2000/xmlns/ связывать xmlns с пространством имен http://www.w3.org/2000/xmlns.
Стандарт SAX2 предлагает, значение по умолчанию для QXmlSimpleReader http://xml.org/sax/features/namespaces установлено в true, а для http://xml.org/sax/features/namespace-prefixes в false. Отметим, что комбинация QXmlSimpleReader::setFeature(), связанная с установлением обеих опций в false является незаконной.
[править] Заключение
QXmlSimpleReader поддерживает следующие правила:
(namespaces, namespace-prefixes) | Префикс пространства имен и локальная часть | Квалифицированные имена | Отображение префикса | Атрибуты xmlns |
---|---|---|---|---|
(true, false) | Yes | Yes* | Yes | No |
(true, true) | Yes | Yes | Yes | Yes |
(false, true) | No* | Yes | No* | Yes |
(false, false) | Illegal |
Поведение записей, отмеченных звездочкой (*) не определено в SAX.
[править] Свойства
Свойства are a more general concept. They have a unique name, represented as an URI, but their value is void*. Thus nearly anything can be used as a property value. This concept involves some danger, though: there is no means of ensuring type-safety; the user must take care that they pass the right type. Свойства are useful if a reader supports special handler classes.
The URIs used for features and properties often look like URLs, e.g. http://xml.org/sax/features/namespace. This does not mean that the data required is at this address. It is simply a way of defining unique names.
Anyone can define and use new SAX2 properties for their readers. Property support is not mandatory.
To set or query properties the following functions are provided: QXmlReader::setProperty(), QXmlReader::property() and QXmlReader::hasProperty().
[править] Классы Qt DOM
[править] Введение в DOM
DOM представляет интерфейс для доступа или изменения содержания и структуры XML файла. Он формирует иерархическое представление документа (представление в виде дерева). В противоположность интерфейсу SAX2 , объектная модель документа после синтаксического анализа располагается в памяти, что позволяет легко ей манипулировать.
Все узлы DOM в дереве документа являются подклассами QDomNode. Сам документ представляется как объект QDomDocument.
Ниже представлены доступные классы узлов и указано - есть ли у них дочерние классы:
- QDomDocument: возможны дочерние классы
- QDomElement (максимум один)
- QDomProcessingInstruction
- QDomComment
- QDomDocumentType
- QDomDocumentFragment: возможны дочерние классы
- QDomDocumentType: нет дочерних классов
- QDomEntityReference: возможны дочерние классы
- QDomElement: возможны дочерние классы
- QDomAttr: возможны дочерние классы
- QDomProcessingInstruction: нет дочерних классов
- QDomComment: возможны дочерние классы
- QDomText: нет дочерних классов
- QDomCDATASection: нет дочерних классов
- QDomEntity: возможны дочерние классы
- QDomNotation: нет дочерних классов
QDomNodeList и QDomNamedNodeMap - две коллекции классов, которые обеспечивают: QDomNodeList - список узлов, а QDomNamedNodeMap обработку неупорядоченного набора узлов (часто используется для атрибутов).
Класс QDomImplementation позволяет пользователю запрашивать особенности обработки DOM.
Прежде чем начать работать пожалуйста посмотрите документацию QDomDocument. Вы также можете захотеть посмотреть пример DOM Bookmarks, который иллюстрирует применение DOM для чтения и записи закладок XML файла (XBEL).
[править] Введение в пространство имен (NameSpace)
Часть разделов документации Qt XML module предполагает, что вы знакомы с пространством имен XML. Здесь мы даем краткое введение. Если вы знакомы с Qt XML documentation conventions, то можете пропустить данный материал.
Пространство имен - это концепция, введенная в XML, чтобы позволить осуществлять более модульное проектирование. С его помощью во время программной обработки данных можно легко разрешить конфликты именования имен в XML документах.
Рассмотрим следующий пример:
<document> <book> <title>Practical XML</title> <author title="Ms" name="Eris Kallisti"/> <chapter> <title>A Namespace Called fnord</title> </chapter> </book> </document>
Здесь можно увидеть три различных использования имени title. Если вы захотите обработать данный документ, то у вас появятся проблемы, поскольку каждый из titles должен представляться в разной манере, несмотря на то, что используется одно и тоже имя.
Решение должно основываться на неком способе, позволяющем идентифицировать первый title как название книги, т.е. использовать элемент title в пространстве имен книги для отличия его, например, от названия раздела:
<book:title>Practical XML</book:title>
В данном случае book является префиксом, указывающим на пространство имен.
До того, как применять пространство имен для элементов и атрибутов, необходимо его объявить.
Пространство имен подобно URI: http://trolltech.com/fnord/book/. Данное URI не указывает, что по этому адресу должны быть доступны данные. URI просто используется для задания уникального имени.
Мы указываем пространства имен точно также как и атрибуты. Строго говоря они и есть атрибуты. Для того, чтобы объявить пространство имен документа http://trolltech.com/fnord/ как пространство имен по умолчанию, мы должны написать
xmlns="http://trolltech.com/fnord/"
Чтобы отличить пространство имен http://trolltech.com/fnord/book/ от пространства имен по умолчанию, мы должны использовать префикс:
xmlns:book="http://trolltech.com/fnord/book/"
Пространство имен, объявленное таким образом, может быть добавлено к именам элементов и атрибутов посредством префикса и разделителя ":". Мы уже видели это у элемента book:title.
Имена элементов без префикса принадлежат пространству имен по умолчанию. Данное правило не распространяется на атрибуты. Атрибут без префикса вообще не принадлежит никакому объявленному пространству имен XML. Атрибуты всегда принадлежат к "традиционному" пространству имен элемента, с которым они применяются. "Традиционное" пространства имен это не пространства имен XML. Просто предполагается, что все имена атрибутов, принадлежащие одному элементу, должны быть разными. Далее мы увидим как назначается пространство имен XML для атрибута.
Фактически атрибуты без префикса не принадлежат никакому пространству имен XML, при этом нет коллизии между атрибутом title (который принадлежит элементу author) и, например, элементом title в контейнере chapter.
Давайте проясним это на примере:
<document xmlns:book = 'http://trolltech.com/fnord/book/' xmlns = 'http://trolltech.com/fnord/' > <book> <book:title>Practical XML</book:title> <book:author xmlns:fnord = 'http://trolltech.com/fnord/' title="Ms" fnord:title="Goddess" name="Eris Kallisti"/> <chapter> <title>A Namespace Called fnord</title> </chapter> </book> </document>
В элементе document мы имеем два объявления пространства имен. Пространство имен по умолчанию http://trolltech.com/fnord/ применяется к элементу book, элементу chapter, соответствующему элементу title и, конечно, к самому элементу document.
Элементы book:author и book:title принадлежат пространству имен, идентифицируемому URI http://trolltech.com/fnord/book/.
Двум атрибутам title и name элемента book:author не назначено пространство имен XML. Они являются членами "традиционного" пространства имен элемента book:author. Это означает, что, например, два атрибута title в book:author недопустимо.
Выше в примере мы обошли данное правило. Мы объявили пространство имен http://trolltech.com/fnord/ с префиксом fnord в элементе book:author и добавили этот префикс к атрибуту title элемента book:author.
Очевидно, пространство имен fnord имеет точно такое же URI, что и пространство имен по умолчанию. Почему же мы просто не использовали ранее объявленное пространство имен по умолчанию? Ответ не совсем простой:
- атрибуты без префикса вообще не принадлежат никакому пространству имен, даже пространству имен по умолчанию;
- пренебрежение префиксом будет приводить к конфликту типа title-title;
- запись префикса как xmlns:title позволит объявить новое пространство имен с префиксом title вместо используемого пространства имен по умолчанию xmlns.
Используя классы Qt XML доступ к элементам и атрибутам может осуществляться двумя способами: либо ссылаясь на их квалифицированные имена, включающие префикс пространства имен и "реальное" имя (или "локальное" имя), либо используя комбинацию локального имени и URI пространства имен.
Дополнительную информацию о пространстве имен XML можно найти на http://www.w3.org/TR/REC-xml-names/.
[править] Conventions Used in the Qt XML Documentation
Следующие термины используются для различия частей имен в контексте пространства имен:
- квалифицированное имя (qualified name) - это имя как оно представляется в документе. (В примерах, представленных выше, book:title это квалифицированное имя.)
- префикс пространства имен (namespace prefix) - часть квалифицированного имени слева от ":". (book - это префикс пространства имен в book:title.)
- локальная часть (local part) - часть квалифицированного имени справа от ":" (иногда ее называют локальное имя (local name)). (title - локальная часть часть book:title.)
- пространство имен URI (namespace URI ("Uniform Resource Identifier")) - это уникальный идентификатор пространства имен. Внешне он выглядит подобно URL (например, http://trolltech.com/fnord/ ), но не требует, чтобы по этому адресу были доступны какие-либо данные.
Элементы без ":" (в примере подобно chapter) не имеют префикса пространства имен. В этом случае локальная часть и квалифицированное имя идентичны (например, chapter).
Также смотрите DOM Bookmarks Example и SAX Bookmarks Example.
[Previous: QtSvg Module ] [ Qt's Modules ] [Next: QtDesigner Module ]
Copyright © 2007 Trolltech | Trademarks | Qt 4.3.2
|