XML C++ Library 프로젝트 소개

요새 개인적으로 C++용 XML parser interface를 만들어 보고 있습니다. 가능한한 C++ 답게 만들어 보려고 합니다. 자체적으로 XML parsing을 하는건 아니고 기존에 존재하는 parser들의 wrapper라고 보시면 됩니다. ((나중에 자체 parser를 제작할까도 생각중입니다만 당분간은 다른 parser들의 wrapper를 제공하는 것이 목적입니다.))

일단 찾을 수 있었던 것들 중 제일 간단한 TinyXML을 가지고 wrapping해보고 있는 중입니다. 이게 끝나면 제일 복잡해 보이는 Xerces을 가지고 해보려고 합니다. 제일 간단한 것과 제일 복잡한 것의 common interface가 가능하면 그 중간에 있는 것들은 모두 가능하지 않을까라는 생각입니다.

간단히 소개를 하면 다음과 같습니다.

먼저 하나의 XML 문서는 node들로 구성됩니다. node의 종류에는 document, declaration, element, text, comment, unknown node들이 있습니다. 실제 XML 문서의 node는 아니지만 null node type이 몇몇 method의 null object design pattern 구현을 위해 존재합니다. 이들 node 클래스외에 exception 클래스와 attribute 클래스가 존재합니다.

예를 들어 보면 다음과 같습니다.

<!-- document node -->
<?xml version="1.0"?>                      <!-- declaration node -->
<collection>                               <!-- element node -->
  <!-- collection of recipes -->             <!-- comment node -->
  ...
  <recipe>                                 <!-- element node -->
    ...
    <comment>                              <!-- element node -->
      Make the meat ahead of time, and     <!-- text node -->
    </comment>
    <nutrition calories="1167" fat="23" /> <!-- element node with attributes -->
  </recipe>
</collection>

document node는 전체 XML 문서를 나타냅니다. element node는 각 element를 나타내며 child node를 가질 수 있습니다. 또한 element node는 attribute을 가질 수 있습니다. declaration node는 version이나 encoding, standalone 정보를 가질 수 있습니다. 나머지 comment, text, unknown node들은 자신만의 value외에 특별한 정보를 가지고 있지 않습니다.

먼저 XML 문서를 열기 위해 다음과 같은 방법을 사용합니다.

using namespace xmlcpp;

node_document doc("recipes.xml");
// or
node_document doc;
doc.load_file("recipes.xml");

위에서 얻은 node_document 객체를 가지고 child node들을 다음과 같이 iterator를 사용하여 얻을 수 있습니다. ((node_document는 어차피 하나만의 element node를 가질 수 있으며 이는 node_document 클래스의 get_root_element() 함수를 통해서도 얻을 수 있습니다.))

for (node_base::iterator i = doc.begin(); i != doc.end(); ++i) {
  node_base& node = *i;
}

node_base는 모든 node 클래스들의 parent class입니다. node_base는 child node들의 iteration을 위해 다음과 같은 타입의 iterator들을 제공합니다.

# iterator
# const_iterator
# reverse_iterator
# const_reverse_iterator

이외에 element node들만을 iterate 하고자 할 때 사용할 수 있는 elem_iterator 들도 제공합니다.

# elem_iterator
# elem_const_iterator
# elem_reverse_iterator
# elem_const_reverse_iterator

만약 "collection"라는 value를 가진 child node를 찾고자 한다면 다음과 같이 stl의 알고리즘을 사용할 수 있습니다. ((여기서 value_equal_to는 본 라이브러리에서 제공하는 helper functor입니다. 이외에 attribute 검색을 위한 name_equal_to도 제공합니다.))

node_base::iterator i = find_if(doc.begin(), doc.end(), value_equal_to("collection"));
if (i != doc.end()) ...

하지만 이런 식으로 child node를 계속 따라가며 검색하는 것은 조금 번거롭습니다. 따라서 다음과 같이 cascading을 지원하는 get_node() 함수를 제공합니다.

node_base& node = doc.get_node("collection").get_node("recipe").get_node("comment");
if (node.get_node_type() == node_base::null_type) ...

이때 중간에 값이 없더라도 cascading이 이루어지도록 하기 위해 null object design pattern이 사용됩니다. 따라서 이 경우엔 결과로 받은 node의 type이 null type인지를 검사해야 합니다.

위의 코드를 좀 더 간단하게 작성할 수 있도록 get_node() 함수의 wrapper인 operator()를 제공합니다. 위의 코드는 아래처럼 간단하게 작성될 수 있습니다.

node_base& node = doc("collection")("recipe")("comment");
if (node.get_node_type() == node_base::null_type) ...

node들 중 element_node는 특별히 attr_iterator를 추가로 제공합니다. ((이 attr_iterator 또한 const, reverse들의 타입을 제공합니다.)) 사용법의 예를 들면 다음과 같습니다.

node_base& node = doc("collection")("recipe")("nutrition");
if (node.get_node_type() == node_base::element_type) {
  node_element& elem = dynamic_cast(node);
  for (node_element::attr_iterator i = elem.attr_begin(); i != elem.attr_end(); ++i) {
    attribute& attr = *i;
  }
}

또한 element_node는 특정 name을 가진 attribute를 찾을 때 사용할 수 있는 find() 함수도 제공합니다. 각 attribute 클래스는 get_name()과 get_value()함수를 제공하며 각 리턴 타입은 char const*입니다. 만약 value를 int 타입으로 읽고 싶다면 다음과 같이 template method를 사용할 수 있습니다. ((이 함수는 내부적으로 boost::lexical_cast를 사용합니다. 따라서 형변환이 안되는 타입을 변환하려고 하면 boost::bad_lexical_cast 예외가 발생합니다.))

string s = attr.get_value();
int n = attr.get_value<int>();

이번 글에서 설명한 iterator, elem_iterator, attr_iterator family들은 모두 bidirectional iterator category입니다.

위에서 설명한 내용외에 Visitor design pattern을 node class들에서 제공하여 node에 대한 추가 operation이 필요한 경우 사용자들이 직접 구현할 수 있도록 했습니다. ostream에 XML 문서를 들여쓰기하여 출력할 수 있는 기능이 node_printer라는 node_visitor 클래스의 구현을 통해 제공됩니다.

이상이 현재까지 구현된 내용의 소개입니다. 아직 주로 XML DOM 트리를 읽는 방법들입니다. 앞으로 DOM 트리를 생성할 수 있는 interface를 만들 예정입니다.

관심 있으신 분들은 개선 사항이나 추가 구현이 필요한 내용을 알려 주시면 반영해 보도록 하겠습니다.

sf.net에 프로젝트를 신청해 놓았는데 아직 processing중이네요. 소스 코드는 신청이 접수되면 바로 CVS에 등록할 예정입니다.