Skip to main content

XMLCPP Library 0.9

며칠간 뚝딱거려서 만든 XMLCPP Library의 최초 버전을 release하였습니다.

라이브러리의 홈페이지에서 간단한 사용법을 보실 수 있습니다.

라이브러리가 지원하는 표준은 다음과 같습니다.


  1. XmlPull v1 API

  2. XML InfoSet의 모든 문법

  3. XML Namespaces

  4. XML Recommendation에 정의된 CharClasses



현재 DTD를 사용한 validation은 구현되어 있지 않습니다. 간단히 말하면 non-validating XML pull parser입니다. 물론 DTD에 대한 문법 검사는 수행합니다. ((이 기능은 Roadmap에 따라 차후 구현될 예정입니다.))

Entity ref를 위한 name/value pair는 XmlPull v1 API에 정의되어 있는 define_entity_replacement_text(name, text)를 사용하여 수동으로 입력하여 사용할 수 있습니다.

Requirements



이 XMLCPP Library를 사용하기 위해서는 다음의 두 라이브러리가 필요합니다. ((둘 다 Windows 환경에서도 사용 가능합니다만 아직 Windows로의 포팅 작업은 이루어지지 않았습니다. Roadmap 부분을 참고하세요.))


  1. Boost C++ Library

  2. libiconv



Usage



구현된 PullParser의 간단한 사용예는 다음과 같습니다.


  using namespace xmlcpp;

  try {
    fstream fs(filename);
    fs.exceptions (ios_base::badbit);

    PullParser pp;
    pp.set_input(fs, encoding);

    while (pp.next() != PullParser::END_DOCUMENT) {
      wcout << PullParser::event_type_c_str(pp.get_event_type()) << L": " << endl;
      switch (pp.get_event_type()) {
      case PullParser::START_TAG:
	wcout << L"tname="" << pp.get_name() << L""" << endl;
	for (int i = 0; i < pp.get_attr_size(); ++i) {
	  wcout << L"tt" << pp.get_attr_name(i)
		<< L"="" << pp.get_attr_value(i) << L""" << endl;
	}
	break;
      case PullParser::END_TAG:
	wcout << L"tname="" << pp.get_name() << L""" << endl;
	break;
      case PullParser::TEXT:
	wcout << L"ttext="" << pp.get_text() << L""" << endl;
	break;
      default:
	wcout << L"ttext="" << pp.get_raw_text() << L""" << endl;
	break;
      }
    }

    wcout << L"END_DOCUMENT: " << endl;
  }
  catch (exception& ex) {
    wcout << ex.what() << endl;
  }


위의 코드는 PullParser의 next()함수를 사용한 것으로 next()함수는 다음 4개의 event_type만 리턴합니다.


  1. START_TAG

  2. TEXT

  3. END_TAG

  4. END_DOCUMENT



next()함수에서는 "<ABC>"라는 문자열은 하나의 TEXT event로 리턴되며 get_text()의 값은 ""가 됩니다.

next() 함수보다 좀 더 자세한 내용이 필요하다면 next_token()함수를 사용할 수 있습니다. 이 함수는 next()가 리턴하는 event_type에 더해 다음을 추가로 리턴합니다.


  1. START_DOCUMENT

  2. IGNORABLE_WHITESPACE

  3. CDSECT

  4. PROCESSING_INSTRUCTION

  5. COMMENT

  6. ENTITY_REF

  7. DOCDECL



위에서 예를 든 "<ABC>"라는 문자열은 next_token()함수를 사용하면 ENTITY_REF, TEXT, ENTITY_REF 이렇게 3개의 event_type으로 나누어져서 리턴됩니다. 각 ENTITY_REF event의 경우에는 get_raw_text()에서는 "<"를, get_text()에서는 "<"을 리턴합니다. ENTITY_REF이 유일하게 get_raw_text()와 get_text()가 다른 값을 리턴하는 event_type입니다.


  using namespace xmlcpp;

  try {
    fstream fs(filename);
    fs.exceptions (ios_base::badbit);

    PullParser pp;
    pp.set_input(fs, encoding);

    while (pp.next_token() != PullParser::END_DOCUMENT) {
      wcout << PullParser::event_type_c_str(pp.get_event_type()) << L": " << endl;
      switch (pp.get_event_type()) {
      case PullParser::START_DOCUMENT:
	wcout << L"tversion="" << pp.get_version() << L""" << endl;
	wcout << L"tencoding="" << pp.get_encoding() << L""" << endl;
	wcout << L"tstandalone"" << pp.get_standalone() << L""" << endl;
	break;
      case PullParser::START_TAG:
	wcout << L"tname="" << pp.get_name() << L""" << endl;
	for (int i = 0; i < pp.get_attr_size(); ++i) {
	  wcout << L"tt" << pp.get_attr_name(i)
		<< L"="" << pp.get_attr_value(i) << L""" << endl;
	}
	break;
      case PullParser::END_TAG:
	wcout << L"tname="" << pp.get_name() << L""" << endl;
	break;
      case PullParser::TEXT:
	wcout << L"ttext="" << pp.get_raw_text() << L""" << endl;
	break;
      case PullParser::IGNORABLE_WHITESPACE:
	break;
      case PullParser::CDSECT:
	wcout << L"ttext="" << pp.get_raw_text() << L""" << endl;
	break;
      case PullParser::PROCESSING_INSTRUCTION:
	wcout << L"ttext="" << pp.get_raw_text() << L""" << endl;
	break;
      case PullParser::COMMENT:
	wcout << L"ttext="" << pp.get_raw_text() << L""" << endl;
	break;
      case PullParser::ENTITY_REF:
	wcout << L"ttext="" << pp.get_raw_text() << L""" << endl;
	break;
      case PullParser::DOCDECL:
	wcout << L"ttext="" << pp.get_raw_text() << L""" << endl;
	break;
      default:
	wcout << L"ttext="" << pp.get_raw_text() << L""" << endl;
	break;
      }
    }

    wcout << L"END_DOCUMENT: " << endl;
  }
  catch (exception& ex) {
    wcout << ex.what() << endl;
  }


Roadmap



현재 Linux 환경에서만 test되었으며 다음과 같은 roadmap을 가지고 작업할 예정입니다.


  1. XmlPull v1 API의 Serializer 구현 (writing XML)

  2. MS VC++에서 사용 가능하도록 포팅

  3. DTD를 이용한 validation 구현

  4. PullParser를 이용한 SAX parser 구현

  5. SAX parser를 이용한 DOM 구현

  6. DOM을 이용한 XPath 및 기타 기능 구현



Downloads



다운로드는 여기서 할 수 있습니다.

Help Wanted



XMLCPP Library 개발에 관심 있으신 분들은 참여해 주세요. 특히 현재 위의 2번 항목 VC++로의 포팅에 도움이 필요할 듯 합니다. 한번 해봤는데 오랫만에 VC++를 사용하려니 잘 안되더군요. :-| 참고로 libiconv 라이브러리는 Windows용도 있습니다.
Labels:

Comments

Post a Comment

Popular posts from this blog

CodeHighlighter plugin test page.

This post is for testing CodeHighlighter plugin which uses GeSHi as a fontifier engine. ((Those code blocks are acquired from Google Code Search .)) ((For more supported languages, go CodeHighlighter plugin or GeSHi homepage.)) C++ (<pre lang="cpp" lineno="1">) class nsScannerBufferList { public: /** * Buffer objects are directly followed by a data segment. The start * of the data segment is determined by increment the |this| pointer * by 1 unit. */ class Buffer : public PRCList { public: Buffer() { ++index_; } PHP (<pre lang="php" lineno="4">) for ($i = 0; $i $value = ord( $utf8_string[ $i ] ); if ( $value < 128 ) { // ASCII $unicode .= chr($value); } else { if ( count( $values ) == 0 ) { $num_octets = ( $value } $values[] = $value; Lisp (<pre lang="lisp">) ;;; Assignment (define-caller-pattern setq ((:star var fo...
88 comments
Read more

C++ of the Day #43 - SQLite3 C++ wrapper #1

The Definitive Guide to SQLite 를 읽다가 공부 겸 해서 C++ wrapper를 만들어 보았습니다. 최대한 C++ 냄새(?)가 나도록 만들어 보았습니다. :-) ((SQLite는 복잡한 관리가 필요없이 사용가능한, 파일이나 메모리 기반의, 라이브러리로 제공되는, 약 250kb 용량의, 대부분의 SQL92문을 지원하는, open source RDB입니다.)) 이 wrapper를 사용하기 위해서는 (당연하게도!) sqlite3 와 (당연하게도?) boost 라이브러리가 필요합니다. 사용 예들을 살펴보는 것으로 설명을 대신합니다. 이번 글에서는 다음과 같은 contacts 테이블이 test.db에 존재한다고 가정합니다. CREATE TABLE contacts ( id INTEGER PRIMARY KEY, name TEXT NOT NULL, phone TEXT NOT NULL, UNIQUE(name, phone) ); Command 먼저 test.db 파일을 사용하기 위해 다음과 같이 파일 이름을 주어 connection 객체를 생성합니다. 생성과 동시에 test.db와 연결이 이루어집니다. ((생성자외에 open() 함수를 사용할 수도 있습니다.)) sqlite3pp::connection conn("test.db"); 다음은 contacts 테이블에 정보를 추가하는 가장 간단한 방법입니다. connection 클래스에서 제공하는 execute 함수를 사용합니다. ((executef 함수를 사용하면 printf와 같은 문법을 사용하여 query문을 작성할 수 있습니다.)) conn.execute("INSERT INTO contacts (name, phone) VALUES ('user', '1234')"); 위와 동일한 작업을 parameterized query를 사용하여 할 수도 있습니다. ((step()함수가 실제 query문을 수행하는 함수입니다. ...
4 comments
Read more

Textiler plugin test page

This post is for testing Textiler plugin . This plugin uses Textile engine (version 2.0.0). The sample text is come from Textile test page. (Note that the result will be vary according to your CSS options.) Supported wiki syntax Rendering result h2{color:green}. This is a title h3. This is a subhead p{color:red}. This is some text of dubious character. Isn't the use of "quotes" just lazy writing -- and theft of 'intellectual property' besides? I think the time has come to see a block quote. bq[fr]. This is a block quote. I'll admit it's not the most exciting block quote ever devised. Simple list: #{color:blue} one # two # three Multi-level list: # one ## aye ## bee ## see # two ## x ## y # three Mixed list: * Point one * Point two ## Step 1 ## Step 2 ## Step 3 * Point three ** Sub point 1 ** Sub point 2 Well, that went well. How about we insert an <a href="/" title="watch out">old-fashioned hypertext link</a>? Will the quo...
24 comments
Read more