TinyXML实现快捷方便的XML文件读写

TinyXML简介

TinyXML是目前非常流行的一款基于DOM模型的XML解析器，简单易用且小巧玲珑，非常适合存储简单数据，配置文件，对象序列化等数据量不是很大的操作，尤其适用于游戏开发，在Nebula2，CEGUI等开源项目中都有使用。本文对TinyXML读写XML文件进行了重新封装，能方便的解决XML文档读写。

 

     关于DOM和SAX

DOM - Document Object Model

将整篇XML文档一次性解析并读入内存，保存为一个对象供用户访问。

SAX - Simple API for XML

SAX的XML解析方式是基于事件回调的，解析器在每遇到一个XML元素时都会产生一个事件，并执行由用户提供的处理函数。

 

TinyXML类结构

 

[TiXmlBase] 所有TinyXML类的基类，保存该结点或属性在XML原文中的信息。

[TiXmlAttribute] XML结点属性，一个键值对

[TiXmlNode] XML结点的基类，封装了对XML文档树形结构进行操作和维护的方法

[TiXmlComment] XML注释结点

[TiXmlDeclaration] XML声明结点

[TiXmlDocument] XML文档结点（一般为一篇XML文档的根结点）

[TiXmlElement] XML结点

[TiXmlText] XML文本结点

[TiXmlUnknown] 含有未知标签的XML结点

[TiXmlHandle] 封装了一个结点的指针，在对该指针进行查询时将自动进行空指针交验

[TiXmlVisitor] 遍历器接口，描述了每个节点的处理方法，由子类实现

[TiXmlPrinter] Printer遍历器

 

l        读取XML文件

TiXmlDocument doc("test.xml");

doc.LoadFile("test.xml");

 

l        写入 XML 文件

TiXmlDocument doc;

……

doc.SaveFile("test.xml");

 

l        遍历XML文档

首先以FirstChild获得第一个自节点，然后以NextSibling获取下个兄弟节点；如此递归遍历所有节点即可。

TiXmlNode::FirstChild();

TiXmlNode::NextSibling();

 

l        构造XML文档

将指定节点插入当前节点子节点队列的末尾

TiXmlNode::LinkEndChild();

设置指定节点的属性

TiXmlElement::SetAttribute();

TiXmlElement::SetDoubleAttribute();

 

XML读写的逻辑封装

  针对不同的应用对XML的读写进行再次封装能提升工作的效率和代码的可读性等。

 

#pragma  once
#include  " stdafx.h "
#include  " tinyxml.h "

// XML 文件的读写

class  AttXMLDoc
... {
public:
    AttXMLDoc(void);
    ~AttXMLDoc(void);

    //XML读写迭代器    
    void BeginExchange(const char* szFileName,const char* szAttName,bool bSave);
    bool NextAtt();

    //读写XML节点
    void ExchangeField(const char* szFieldName,DWORD& val);
    void ExchangeField(const char* szFieldName,WORD& val);
    void ExchangeField(const char* szFieldName,BYTE& val);
    void ExchangeField(const char* szFieldName,int& val);
    void ExchangeField(const char* szFieldName,bool& val);
    void ExchangeField(const char* szFieldName,float& val);
    void ExchangeField(const char* szFieldName,char* szValBuf,int bufLen);

    //XML读写迭代器    
    void EndExchange();

private:
    TiXmlDocument    m_doc;
    TiXmlElement    *m_rootElement;
    TiXmlElement    *m_curElement;
    bool            m_bSave;
    string            m_szName;
} ;

   源文件实现：

 

#include  " StdAfx.h "
#include  " .attxmldoc.h "

AttXMLDoc::AttXMLDoc( void )
... {
    m_curElement = NULL;
    m_rootElement = NULL;
    m_bSave = true;
}

AttXMLDoc:: ~ AttXMLDoc( void )
... {
}

char  eleName[ 256 ] = " Att " ;
void  AttXMLDoc::BeginExchange( const   char *  szFileName, const   char *  szAttName, bool  bSave)
... {
    m_bSave = bSave;
    m_szName = szFileName;

    if(bSave)
    ...{
        TiXmlDeclaration *decl = new TiXmlDeclaration("1.0","GB2312","yes");
        m_doc.LinkEndChild(decl);
        
        m_rootElement = new TiXmlElement(szAttName);
        m_doc.LinkEndChild(m_rootElement);
    }
    else
    ...{
        m_doc.LoadFile(szFileName);
        m_rootElement = m_doc.RootElement();
        m_curElement = m_rootElement->FirstChildElement(eleName);
    }
}

bool  AttXMLDoc::NextAtt()
... {
    if(m_bSave)
    ...{
        if(m_curElement != NULL)
            m_rootElement->LinkEndChild(m_curElement);
        
        m_curElement = new TiXmlElement(eleName);
        
        return true;
    }
    else
    ...{
        m_curElement = m_curElement->NextSiblingElement(eleName);
        return m_curElement!=NULL;
    }
}

void  AttXMLDoc::ExchangeField( const   char *  szFieldName, int &  val)
... {
    ASSERT(m_curElement != NULL );
    
    if(m_bSave)
    ...{
        m_curElement->SetAttribute(szFieldName,val);
    }
    else
    ...{
        const char* szFind = m_curElement->Attribute(szFieldName,&val);
        ASSERT(szFind != NULL);
    }
}

void  AttXMLDoc::ExchangeField( const   char *  szFieldName, bool &  val)
... {
    ASSERT(m_curElement != NULL );

    if(m_bSave)
    ...{
        m_curElement->SetAttribute(szFieldName,val);
    }
    else
    ...{
        int _val = 0;
        const char* szFind = m_curElement->Attribute(szFieldName,&_val);
        ASSERT(szFind != NULL);
        val = _val!=0 ;
    }
}

void  AttXMLDoc::ExchangeField( const   char *  szFieldName,WORD &  val)
... {
    ASSERT(m_curElement != NULL );

    if(m_bSave)
    ...{
        m_curElement->SetAttribute(szFieldName,val);
    }
    else
    ...{
        int _val = 0;
        const char* szFind = m_curElement->Attribute(szFieldName,&_val);
        ASSERT(szFind != NULL);
        val = (WORD)_val ;
    }
}

void  AttXMLDoc::ExchangeField( const   char *  szFieldName,BYTE &  val)
... {
    ASSERT(m_curElement != NULL );

    if(m_bSave)
    ...{
        m_curElement->SetAttribute(szFieldName,val);
    }
    else
    ...{
        int _val = 0;
        const char* szFind = m_curElement->Attribute(szFieldName,&_val);
        ASSERT(szFind != NULL);
        val = (BYTE)_val ;
    }
}

void  AttXMLDoc::ExchangeField( const   char *  szFieldName,DWORD &  val)
... {
    ASSERT(m_curElement != NULL );

    if(m_bSave)
    ...{
        m_curElement->SetAttribute(szFieldName,val);
    }
    else
    ...{
        int _val = 0;
        const char* szFind = m_curElement->Attribute(szFieldName,&_val);
        ASSERT(szFind != NULL);
        val = _val;
    }
}

void  AttXMLDoc::ExchangeField( const   char *  szFieldName, float &  val)
... {
    ASSERT(m_curElement != NULL );

    if(m_bSave)
    ...{
        m_curElement->SetDoubleAttribute(szFieldName,val);
    }
    else
    ...{
        double _val = 0;
        const char* szFind = m_curElement->Attribute(szFieldName,&_val);
        ASSERT(szFind != NULL);
        val = (float)_val;
    }
}


void  AttXMLDoc::ExchangeField( const   char *  szFieldName, char *  szValBuf, int  bufLen)
... {
    ASSERT(m_curElement != NULL );

    if(m_bSave)
    ...{
        m_curElement->SetAttribute(szFieldName,szValBuf);
    }
    else
    ...{
        const char* szFind = m_curElement->Attribute(szFieldName);
        if(szFind != NULL)
            strncpy(szValBuf,szFind,bufLen-1);
    }
}

void  AttXMLDoc::EndExchange()
... {
    if(m_bSave)
    ...{
        if(m_curElement != NULL)
        ...{
            m_rootElement->LinkEndChild(m_curElement);
            m_doc.SaveFile(m_szName.c_str());
        }
    }
}

读写XML文件实例：（略）

XML文件的读写在开发中起这很重要的作用，C++本身没有提供XML解析器，TinyXML是一个小巧高效实用的XML文档解析器，好好利用起来会很大程度上提升工作效率。