gloox代碼分析2 - xml parser模塊

gloox自己實(shí)現(xiàn)了xml的解析模塊，沒有用到第三方的庫(tinyXML，expat )
主要涉及的文件:
tag.h (tag.cpp)
taghandler.h
parser.h (parser.cpp)

1. Tag一個Tag就是一個XML元素
例如:
a.
<book kind='computer'>
  <store id='23'/>
  <author>
    qiang
  </author>
</book>
b. <book id='32'/>
c. <book>name1</book>

首先介紹一個概念: escape-string，何為escape-string?
在escape-string中:
 '&'轉(zhuǎn)換成&amp;, '<'轉(zhuǎn)換成&lt;, '>'轉(zhuǎn)換成&gt;.
編碼表如下:
//////////////////////////////////////////////////////////////////////////
// 編碼表 （中間的空格去掉，這里只是為了方便顯示）:
// -------------------------------------------------------
// | 字符     | 十進(jìn)制 | 十六進(jìn)制 | THML字符集 | Unicode |
// -------------------------------------------------------
// | " 雙引號 | & # 34;  | & # x22;   | "          | \u0022  |
// -------------------------------------------------------
// | ' 單引號 | & # 39;  | & # x27;   | & apos;     | \u0027  |
// -------------------------------------------------------
// | & 與     | & # 38;  | & # x26;   | & amp;      | \u0026  |
// -------------------------------------------------------
// | < 小于號 | & # 60;  | & # x3C;   | & lt;       | \u003c  |
// -------------------------------------------------------
// | > 大于好 | & # 62;  | & # x3E;   | & gt;       | \u003e  |
// -------------------------------------------------------
gloox - APIs
Tag::escape()    功能: string -> escape-string
Tag::relax()  功能: escape-string -> string

主要成員變量:
attributes - 所有屬性的list
name - 節(jié)點(diǎn)名字
cdata - 節(jié)點(diǎn)數(shù)據(jù)，例如<name>cdata</name>中的cdata
children - 所有的子節(jié)點(diǎn)
parent - 父節(jié)點(diǎn)指針，如果沒有則為空
bool incoming - 表示構(gòu)造xml node的時候傳入的字符串是否是escape-string，如果是，需要在構(gòu)造的時候調(diào)用relex把escape-string轉(zhuǎn)換成string.

主要方法:
也就是一些針對name\children\attributes\cdata進(jìn)行增加\刪除\修改的方法
xml()方法返回該節(jié)點(diǎn)的一個完整的xml數(shù)據(jù)流
findTag和findTagList提供對XPath的支持.

例如:
屏幕將輸出:
<book kind='computer'><store id='23'/><author>qiang</author></book>

2. TagHandler是一個接收parser解析完成的tag的接口，繼承該類，則可以接收parser解析的tag對象事件.
只有一個接口
virtual void handleTag( Tag *tag ) = 0 - 接收解析完的tag

3. Parser一個XML解析器
提供的接口非常簡潔，只需要一個TagHandler來構(gòu)造，該handler接收并處理解析的tag，另外只有一個feed接口來填充數(shù)據(jù).
要注意的是feed接口填充的數(shù)據(jù)必須是一個格式正確的xml，否則無法解析，也就是說parser不會判斷xml的格式。

例如:
下面的例子中對feed來說分開填充和一次性填充數(shù)據(jù)的效果是一樣的，也就是scenario1和scenario2的效果是一樣的，這也剛好和上層應(yīng)用中TCP 流處理的方式統(tǒng)一，對于接收到服務(wù)器端的XML流，無論是否完整，只需要直接feed就可以了。handlerTag方法將收到兩個
xml tag解析完成的事件，分別來自scenario1和scenario2，屏幕將輸出:
<book kind='computer'><store id='23'/><author>qiang</author></book> 
<book kind='computer'><store id='23'/><author>qiang</author></book>

posted on 2008-10-18 14:51 ysong.lee 閱讀(2591) 評論(0)  編輯 收藏 引用