XML与C++对象的相互转化

介绍

这个例子假设你在用一个XML文件来加载和保存你的应用程序配置，举例来说，有点像example4.xml。

有许多方法可以做到这点。例如，看看TinyBind项目：

这一节展示了一种普通老式的方法来使用XML加载和保存一个基本的对象结构。

建立你的对象类

从一些像这样的基本类开始：

 

#include <string>
#include 

这是一个基本的mian()，它向我们展示了怎样创建一个默认的settings对象树，怎样保存并再次加载：

 

int main(void)
{
    AppSettings settings;
    
    settings.save("appsettings2.xml");
    settings.load("appsettings2.xml");
    return 0;
}

接下来的main()展示了如何创建，修改，保存和加载一个settings结构：

 

int main(void)
{
    // 区块：定制并保存settings
    {
        AppSettings settings;
        settings.m_name="HitchHikerApp";
        settings.m_messages["Welcome"]="Don’t Panic";
        settings.m_messages["Farewell"]="Thanks for all the fish";
        settings.m_windows.push_back(WindowSettings(15,25,300,250,"BookFrame"));
        settings.m_connection.ip="192.168.0.77";
        settings.m_connection.timeout=42.0;
        
        settings.save("appsettings2.xml");
    }
    
    // 区块：加载settings
    {
        AppSettings settings;
        settings.load("appsettings2.xml");
        printf("%s: %s\n", settings.m_name.c_str(), 
        settings.m_messages["Welcome"].c_str());
        WindowSettings & w=settings.m_windows.front();
        printf("%s: Show window ’%s’ at %d,%d (%d x %d)\n", 
        settings.m_name.c_str(), w.name.c_str(), w.x, w.y, w.w, w.h);
        printf("%s: %s\n", settings.m_name.c_str(),

                           settings.m_messages["Farewell"].c_str());
    }
    return 0;
}

当save()和load()完成后（请看下面），运行这个main()就会在控制台看到：

 

HitchHikerApp: Don’t Panic
HitchHikerApp: Show window ‘BookFrame’ at 15,25 (300 x 100)
HitchHikerApp: Thanks for all the fish

把C++状态编码成XML

有很多方法能够做到把文档对象保存到文件中，这就是其中一个：

 

void AppSettings::save(const char* pFilename)
{
    TiXmlDocument doc; 
    TiXmlElement* msg;
    TiXmlComment * comment;
    string s;
    TiXmlDeclaration* decl = new TiXmlDeclaration( "1.0", "", "" ); 
    doc.LinkEndChild( decl ); 
    
    TiXmlElement * root = new TiXmlElement(m_name.c_str()); 
    doc.LinkEndChild( root ); 
    
    comment = new TiXmlComment();
    s=" Settings for "+m_name+" ";
    comment->SetValue(s.c_str()); 
    root->LinkEndChild( comment ); 
    
    // 区块：messages
    {
        MessageMap::iterator iter;
        
        TiXmlElement * msgs = new TiXmlElement( "Messages" ); 
        root->LinkEndChild( msgs ); 
        
        for (iter=m_messages.begin(); iter != m_messages.end(); iter++)
        {
            const string & key=(*iter).first;
            const string & value=(*iter).second;
            msg = new TiXmlElement(key.c_str()); 
            msg->LinkEndChild( new TiXmlText(value.c_str())); 
            msgs->LinkEndChild( msg ); 
        }
    }
    
    // 区块：windows
    {
        TiXmlElement * windowsNode = new TiXmlElement( "Windows" ); 
        root->LinkEndChild( windowsNode ); 
        
        list::iterator iter;
        
        for (iter=m_windows.begin(); iter != m_windows.end(); iter++)
        {
            const WindowSettings& w=*iter;
            
            TiXmlElement * window;
            window = new TiXmlElement( "Window" ); 
            windowsNode->LinkEndChild( window ); 
            window->SetAttribute("name", w.name.c_str());
            window->SetAttribute("x", w.x);
            window->SetAttribute("y", w.y);
            window->SetAttribute("w", w.w);
            window->SetAttribute("h", w.h);
        }
    }
    
    // 区块：connection
    {
        TiXmlElement * cxn = new TiXmlElement( "Connection" ); 
        root->LinkEndChild( cxn ); 
        cxn->SetAttribute("ip", m_connection.ip.c_str());
        cxn->SetDoubleAttribute("timeout", m_connection.timeout); 
    }
    
    doc.SaveFile(pFilename); 
}

用修改过的main运行会生成这个文件：

 

   
   
      Thanks for all the fish
      Don't Panic
   
   
      
   
   

从XML中解码出状态

就像编码一样，也有许多方法可以让你从自己的C++对象结构中解码出XML。下面的方法使用了TiXmlHandles。

 

void AppSettings::load(const char* pFilename)
{
    TiXmlDocument doc(pFilename);
    if (!doc.LoadFile()) return;
    
    TiXmlHandle hDoc(&doc);
    TiXmlElement* pElem;
    TiXmlHandle hRoot(0);
    
    // 区块：name
    {
        pElem=hDoc.FirstChildElement().Element();
        // 必须有一个合法的根结点，如果没有则温文地处理（译注：直接返回）
        if (!pElem) return;
        m_name=pElem->Value();
        
        // 保存起来以备后面之用
        hRoot=TiXmlHandle(pElem);
    }
    
    // 区块：string table
    {
        m_messages.clear(); // 清空已有的table
        
        pElem=hRoot.FirstChild( "Messages" ).FirstChild().Element();
        for( pElem; pElem; pElem=pElem->NextSiblingElement())
        {
            const char *pKey=pElem->Value();
            const char *pText=pElem->GetText();
            if (pKey && pText) 
            {
                m_messages[pKey]=pText;
            }
        }
    }
    
    // 区块：windows
    {
        m_windows.clear(); // 清空链表
        
        TiXmlElement* pWindowNode=hRoot.FirstChild( "Windows" )

                                       .FirstChild().Element();
        for( pWindowNode; pWindowNode;

             pWindowNode=pWindowNode->NextSiblingElement())
        {
            WindowSettings w;
            const char *pName=pWindowNode->Attribute("name");
            if (pName) w.name=pName;
            
            pWindowNode->QueryIntAttribute("x", &w.x); // 如果失败，原值保持现状
            pWindowNode->QueryIntAttribute("y", &w.y);
            pWindowNode->QueryIntAttribute("w", &w.w);
            pWindowNode->QueryIntAttribute("hh", &w.h);
            
            m_windows.push_back(w);
        }
    }
    
    // 区块：connection
    {
        pElem=hRoot.FirstChild("Connection").Element();
        if (pElem)
        {
            m_connection.ip=pElem->Attribute("ip");
            pElem->QueryDoubleAttribute("timeout",&m_connection.timeout);
        }
    }
}

dump_to_stdout的完整列表

下面是一个可直接运行的示例程序，使用上面提到过的递归遍历方式，可用来加载任意的XML文件并把结构输出到STDOUT上。

 

// 指南示例程序
#include "stdafx.h"
#include "tinyxml.h"
 
// ———————————————————————-
// STDOUT输出和缩进实用函数
// ———————————————————————-
const unsigned int NUM_INDENTS_PER_SPACE=2;
 
const char * getIndent( unsigned int numIndents )
{
    static const char * pINDENT=" + ";
    static const unsigned int LENGTH=strlen( pINDENT );
    unsigned int n=numIndents*NUM_INDENTS_PER_SPACE;
    if ( n > LENGTH ) n = LENGTH;
    
    return &pINDENT[ LENGTH-n ];
}
 
// 与getIndent相同，但最后没有“+”
const char * getIndentAlt( unsigned int numIndents )
{
    static const char * pINDENT=" ";
    static const unsigned int LENGTH=strlen( pINDENT );
    unsigned int n=numIndents*NUM_INDENTS_PER_SPACE;
    if ( n > LENGTH ) n = LENGTH;
    
    return &pINDENT[ LENGTH-n ];
}
 
int dump_attribs_to_stdout(TiXmlElement* pElement, unsigned int indent)
{
    if ( !pElement ) return 0;
    
    TiXmlAttribute* pAttrib=pElement->FirstAttribute();
    int i=0;
    int ival;
    double dval;
    const char* pIndent=getIndent(indent);
    printf("\n");
    while (pAttrib)
    {
        printf( "%s%s: value=[%s]", pIndent, pAttrib->Name(), pAttrib->Value());
        
        if (pAttrib->QueryIntValue(&ival)==TIXML_SUCCESS) printf( " int=%d", ival);
        if (pAttrib->QueryDoubleValue(&dval)==TIXML_SUCCESS) printf( " d=%1.1f", dval);
        printf( "\n" );
        i++;
        pAttrib=pAttrib->Next();
    }
    return i; 
}
 
void dump_to_stdout( TiXmlNode* pParent, unsigned int indent = 0 )
{
    if ( !pParent ) return;
    
    TiXmlNode* pChild;
    TiXmlText* pText;
    int t = pParent->Type();
    printf( "%s", getIndent(indent));
    int num;
    
    switch ( t )
    {
        case TiXmlNode::DOCUMENT:
            printf( "Document" );
            break;
        
        case TiXmlNode::ELEMENT:
            printf( "Element [%s]", pParent->Value() );
            num=dump_attribs_to_stdout(pParent->ToElement(), indent+1);
            switch(num)
            {
                case 0: printf( " (No attributes)"); break;
                case 1: printf( "%s1 attribute", getIndentAlt(indent)); break;
                default: printf( "%s%d attributes", getIndentAlt(indent), num); break;
            }
            break;
        
        case TiXmlNode::COMMENT:
            printf( "Comment: [%s]", pParent->Value());
            break;
        
        case TiXmlNode::UNKNOWN:
            printf( "Unknown" );
            break;
        
        case TiXmlNode::TEXT:
            pText = pParent->ToText();
            printf( "Text: [%s]", pText->Value() );
            break;
        
        case TiXmlNode::DECLARATION:
            printf( "Declaration" );
            break;
            default:
            break;
    }
    printf( "\n" );
    for ( pChild = pParent->FirstChild(); pChild != 0; pChild = pChild->NextSibling()) 
    {
        dump_to_stdout( pChild, indent+1 );
    }
}
 
// 加载指定的文件并把它的结构输出到STDOUT上
void dump_to_stdout(const char* pFilename)
{
    TiXmlDocument doc(pFilename);
    bool loadOkay = doc.LoadFile();
    if (loadOkay)
    {
        printf("\n%s:\n", pFilename);
        dump_to_stdout( &doc ); 
    }
    else
    {
        printf("Failed to load file \"%s\”\n", pFilename);
    }
}
 
// ———————————————————————-
// main()，打印出从命令行指定的文件
// ———————————————————————-
int main(int argc, char* argv[])
{
    for (int i=1; i     {
        dump_to_stdout(argv[i]);
    }
    return 0;
}

从命令行或者DOS窗口运行它，例如：

 

C:\dev\tinyxml> Debug\tinyxml_1.exe example1.xml
example1.xml:
Document
+ Declaration
+ Element [Hello]
  (No attributes)
  + Text: [World]