QT 4: программирование GUI на С++

Рис. 15.3. Родственные связи между узлами DOM.

Для иллюстрации применения DOM при чтении файлов XML мы напишем парсер для файла предметного указателя книги, описанного в предыдущем разделе.

01 class DomParser
02 {
03 public:
04 DomParser(QIODevice *device, QTreeWidget *tree);
05 private:
06 void parseEntry(const QDomElement &element,
07 QTreeWidgetItem *parent);
08 QTreeWidget *treeWidget;
09 };

Мы определяем класс с названием DomParser, который выполняет синтаксический анализ предметного указателя книги, представленного в виде документа XML, и отображает результат в виджете QTreeWidget. Этот класс не наследует никакой другой класс.

01 DomParser::DomParser(QIODevice *device, QTreeWidget *tree)
02 {
03 treeWidget = tree;
04 QString errorStr;
05 int errorLine;
06 int errorColumn;
07 QDomDocument doc;
08 if (!doc.setContent(device, true, &errorStr,
09 &errorLine, &errorColumn)) {
10 QMessageBox::warning(0, QObject::tr("DOM Parser"),
11 QObject::tr("Parse error at line %1, column %2:\n%3")
12 .arg(errorLine).arg(errorColumn).arg(errorStr));
13 return;
14 }
15 QDomElement root = doc.documentElement;
16 if (root.tagName != "bookindex")
17 return;
18 QDomNode node = root.firstChild;
19 while (!node.isNull) {
20 if (node.toElement.tagName == "entry")
21 parseEntry(node.toElement, 0);
22 node = node.nextSibling;
23 }
24 }

В конструкторе мы создаем объект QDomDocument и вызываем для него функцию setContent, чтобы с его помощью прочесть документ XML с устройства QIODevice. Функция setContent автоматически открывает устройство, если оно еще не открыто. Затем мы вызываем функцию documentElement для объекта QDomDocument, чтобы получить его одиночный дочерний элемент QDomElement, после чего мы проверяем, является ли данный элемент <bookindex>. Мы выполняем цикл по всем дочерним узлам, и если узлом является элемент <entry>, мы вызываем функцию parseEntry для его синтаксического анализа.

Класс QDomNode может хранить узлы любого типа. Если мы хотим продолжить обработку узла, мы должны сначала преобразовать его в правильный тип данных. В нашем примере нас интересуют только узлы Element, и поэтому мы вызываем функцию toElement объекта QDomNode для преобразования его в объект QDomElement и затем вызова функции tagName для получения имени тега элемента. Если данный узел не имеет тип Element, функция toElement возвращает нулевой объект типа QDomElement, содержащий пустое имя тега.

01 void DomParser::parseEntry(const QDomElement &element,
02 QTreeWidgetItem *parent)
03 {
04 QTreeWidgetItem *item;
05 if (parent) {
06 item = new QTreeWidgetTtem(parent);
07 } else {
08 item = new QTreeWidgetItem(treeWidget);
09 }
10 item->setText(0, element.attribute("term"));
11 QDomNode node = element.firstChild;
12 while (!node.isNull) {
13 if (node.toElement.tagName == "entry") {
14 parseEntry(node.toElement, item);
15 } else if (node.toElement.tagName == "page") {
16 QDomNode childNode = node.firstChild;
17 while (!childNode.isNull) {
18 if (childNode.nodeType == QDomNode::TextNode) {
19 QString page = childNode.toText.data;
20 QString allPages = item->text(1);
21 if (!allPages.isEmpty)
22 allPages += ", ";
23 allPages += page;
24 item->setText(1, allPages);
25 break;
26 }
27 childNode = childNode.nextSibling;
28 }
29 }
30 node = node.nextSibling;
31 }
32 }

В функции parseEntry мы создаем элемент объекта QTreeWidget. Если тег вложен в другой <entry>, новый тег определяет подэлемент предметного указателя, и мы создаем элемент QTreeWidgetItem как дочерний для внешнего элемента QTreeWidgetItem. В противном случае мы создаем элемент QTreeWidgetItem с treeWidget в качестве его родительского элемента, делая его элементом верхнего уровня. Мы вызываем функцию setText для установки текста столбца 0 на значение атрибута term тега <entry>.

После инициализации нами элемента QTreeWidgetItem мы выполняем цикл по дочерним узлам элемента QDomElement, который соответствует текущему тегу <entry>.

Если элементом является <entry>, мы вызываем функцию parseEntry, передавая текущий элемент в качестве второго аргумента. Затем будет создан новый элемент QTreeWidgetItem, в качестве родительского элемента которого выступает внешний элемент QTreeWidgetItem.

Если элементом является <page>, мы просматриваем список дочерних элементов для поиска узла Text. После его обнаружения мы вызываем функцию toText для преобразования его в объект типа QDomText и функцию data для получения текста в виде строки типа QString. Затем мы добавляем текст в разделяемый запятыми список номеров страниц в столбце 1 элемента QTreeWidgetItem.