第二人生的源码分析(六十八)LLXMLNode使用Expat库分析XML文件

在前面看到怎么打开XML文件，在那个函数的后面调用parseBuffer函数来分析XML数据，那么在这个函数是怎么样进行XML数据分析的呢？现在就仔细地分析这个函数的代码，它的代码如下：

#001 // static

#002 bool LLXMLNode::parseBuffer(

#003    U8* buffer,

#004    U32 length,

#005    LLXMLNodePtr& node,

#006    LLXMLNode* defaults)

#007 {

 

调用expat库函数XML_ParserCreate来创建一个分析器。

#008    // Init

#009    XML_Parser my_parser = XML_ParserCreate(NULL);

 

设置XML元素的开始函数StartXMLNode和结束函数EndXMLNode。

#010    XML_SetElementHandler(my_parser, StartXMLNode, EndXMLNode);

 

设置不同的字符处理函数XMLData。

#011    XML_SetCharacterDataHandler(my_parser, XMLData);

#012 

 

开始创建一个XML节点。

#013    // Create a root node

#014    LLXMLNode *file_node_ptr = new LLXMLNode("XML", FALSE);

#015    LLXMLNodePtr file_node = file_node_ptr;

#016 

 

保存这个节点的分析器。

#017    file_node->mParser = &my_parser;

#018 

 

设置传送给回调函数的数据。

#019    XML_SetUserData(my_parser, (void *)file_node_ptr);

#020 

 

调用XML_Parse函数进行XML文件分析。

#021    // Do the parsing

#022    if (XML_Parse(my_parser, (const char *)buffer, length, TRUE) != XML_STATUS_OK)

#023    {

#024        llwarns << "Error parsing xml error code: "

#025                << XML_ErrorString(XML_GetErrorCode(my_parser))

#026                << " on lne " << XML_GetCurrentLineNumber(my_parser)

#027                << llendl;

#028    }

#029 

 

XML文件分析完成，然后删除创建的XML分析器。

#030    // Deinit

#031    XML_ParserFree(my_parser);

#032 

 

 

分析XML失败，没有任何数据。

#033    if (!file_node->mChildren || file_node->mChildren->map.size() != 1)

#034    {

#035        llwarns << "Parse failure - wrong number of top-level nodes xml."

#036                << llendl;

#037        node = new LLXMLNode();

#038        return false;

#039    }

#040 

 

返回已经分析好的XML节点树。

#041    LLXMLNode *return_node = file_node->mChildren->map.begin()->second;

#042 

#043    return_node->setDefault(defaults);

#044    return_node->updateDefault();

#045 

#046    node = return_node;

#047    return true;

#048 }

 

从这个函数的代码里看到，跟前面介绍的expat例子是一样的，调用库函数XML_ParserCreate、XML_SetElementHandler、XML_Parse等三个函数就完成了XML的分析过程，只不过这里会把所有分析到的XML数据生成一棵树返回来。