C++. Сборник рецептов - [190]

Пример 14.10. Применение DOM для загрузки, модификации и затем сохранения документа XML

#include
#include  // cout
#include
#include
#include
#include
#include "animal.hpp"
#include "xerces_strings.hpp"

using namespace std;
using namespace xercesc;

/*
 * Определить XercesInitializer, как это сделано в примере 14.8
 */

// Утилита RAII, которая освобождает ресурс при выходе из области видимости.
template
class DOMPtr {
public:
 DOMPtr(T* t) : t_(t) {}
 ~DOMPtr() { t_->release(); }
 T* operator->() const { return t_; }
private:
 // запретить копирование и присваивание
 DOMPtr(const DOMPtr&);
 DOMPtr& operator=(const DOMPtr&);
 T* t_;
};

// Сообщает об ошибках, обнаруженных в ходе синтаксического анализа с
// использованием DOMBuilder.
class CircusErrorHandler : public DOMErrorHandler {
public:
 bool handleFrror(const DOMError& e) {
  std::cout << toNative(e.getMessage()) << "\n";
  return false;
 }
};

// Возвращает значение элемента "name", дочернего по отношению к элементу
// "animal".
const XMLCh* getAnimalName(const DOMElement* animal) {
 static XercesString name = fromNative("name");
 // Просмотреть дочерние элементы объекта animal
 DOMNodeList* children = animal->getChildNodes();
 for (size_t i = 0, len = children->getLength(); i < Len; ++i) {
  DOMNode* child = children->item(i);
  if (child->getNodeType() == DOMNode::ELEMENT_NODE &&
   static_cast(child)->getTagName() == name) {
   // Мы нашли элемент "name".
   return child->getTextContent();
  }
 }
 return 0;
}

int main() {
 try {
  // Инициализировать Xerces и получить DOMImplementation;
  // указать, что требуется функция загрузки и сохранения (Load and
  // Save - LS)
  XercesInitializer init;
  DOMImplementation* impl =
   DOMImplementationRegistry::getDOMImplementation(fromNative("LS").c_str()
  );
  if (impl == 0) {
   cout << "couldn't create DOM implementation\n";
   return EXIT_FAILURE;
  }
  // Сконструировать DOMBuilder для анализа документа animals.xml.
  DOMPtr parser =
   static_cast(impl)->
    createDOMBuilder(DOMImplementationLS::MODE_SYNCHRONOUS, 0);
  // Подключить пространства имен (они не требуются в этом примере)
  parser->setFeature(XMLUni::fgDOMNamespaces, true);
  // Зарегистрировать обработчик ошибок
  CircusErrorHandler err;
  parser->setErrorHandler(&err);
  // Выполнить синтаксический анализ animals.xml; здесь можно
  // использовать URL вместо имени файла
  DOMDocument* doc =
   parser->parseURI("animals.xml");
  // Найти элемент слона Herby: сначала получить указатель на элемент
  // "animalList".
  DOMElement* animalList = doc->getDocumentElement();
  if (animalList->getTagName() != fromNative("animalList")) {
   cout << "bad document root: "
    << toNative(animalist->getTagName()) << "\n";
   return EXIT_FAILURE;
  }
  // Затем просматривать элементы "animal", пытаясь найти элемент слона
  // Herby.
  DOMNodeList* animals =
   animaIList->getElementsByTagName(fromNative("animal").c_str());
  for (size_t i = 0,
   len = animals->getLength(); i < len; ++i) {
   DOMElement* animal =
    static_cast(animals->item(i));
   const XMLCh* name = getAnimalName(animal);
   if (name != 0 && name == fromNative("Herby")) {
    // Herby найден - удалить его из документа.
    animalList->removeChild(animal);
    animal->release();
    // необязательный оператор.
    break;
   }
  }
  // Сконструировать DOMWriter для сохранения animals.xml.
  DOMPtr writer =
   static cast(impl)->createDOMWriter();
  writer->setErrorHandler(&err);
  // Сохранить animals.xml.
  LocalFileFormatTarget file("animals.xml");
  writer->writeNode(&file, *animalList);
 } catch (const SAXException& e) {
  cout << "xml error: " << toNative(e.getMessage()) << "\n";
  return EXIT_FAILURE;
 } catch (const DOMException& e) {
  cout << "xml error: " << toNative(e.getMessage()) << "\n";
  return EXIT_FAILURE;
 } catch (const exception& e) {
  cout << e.what() << "\n";
  return EXIT_FAILURE;
 }
}

Обсуждение

Подобно парсеру TinyXml парсер Xerces DOM на выходе формирует документ XML в виде объекта C++, имеющего структуру дерева, узлы которого представляют компоненты документа. Однако парсер Xerces существенно сложнее: например, в отличие от TinyXml он «понимает» пространства имен XML и может выполнять синтаксический анализ сложных DTD. Этим парсером также формируется гораздо более детальное представление документа XML, включающее инструкции обработки и URI пространств имен, относящиеся к элементам и атрибутам. Очень важно то, что он предоставляет доступ к информации через интерфейс, описанный в спецификации W3C DOM.

Спецификация W3C, которая все еще дорабатывается, имеет несколько «уровней»; в настоящее время предусматривается три уровня. Классы DOMImplementation, DOMDocument, DOMElement и DOMNodeList, использованные в примере 14.10, описываются на уровне 1 спецификации DOM. Классы DOMBuilder и DOMWrite описываются на уровне 3 спецификации DOM как часть рекомендаций по функции загрузки и сохранения (Load и Save).