蔡军生先生第二人生的源码分析(三十五)分析消息模板文件

这种灵活的通讯消息结构到底是怎么样实现的呢？下面就来仔细地分析它实现的代码，如下：
#001 // Read file and build message templates
#002 void LLMessageSystem::loadTemplateFile(const char* filename)
#003 {

首先判断文件名称是否合法。
#004 if(!filename)
#005 {
#006 llerrs << "No template filename specified" << llendl;
#007 mbError = TRUE;
#008 return;
#009 }
#010

然后把这个消息文件从磁盘里读取内存缓冲区。
#011 std::string template_body;
#012 if(!_read_file_into_string(template_body, filename))
#013 {
#014 llwarns << "Failed to open template: " << filename << llendl;
#015 mbError = TRUE;
#016 return;
#017 }
#018

接着调用类LLTemplateTokenizer分析消息文件的单词，相当于词法分析。
#019 LLTemplateTokenizer tokens(template_body);

最后调用类LLTemplateParser来分析消息的结构，生成所有消息模板的结构，并对应到二进制消息构造。
#020 LLTemplateParser parsed(tokens);
#021 mMessageFileVersionNumber = parsed.getVersion();
#022 for(LLTemplateParser::message_iterator iter = parsed.getMessagesBegin();
#023 iter != parsed.getMessagesEnd();
#024 iter++)
#025 {
#026 addTemplate(*iter);
#027 }
#028 }

通过上面一系列的分析，最终调用函数addTemplate添加到类成员变量里，这个函数的代码如下：
#001 void LLMessageSystem::addTemplate(LLMessageTemplate *templatep)
#002 {
#003 if (mMessageTemplates.count(templatep->mName) > 0)
#004 {
#005 llerrs << templatep->mName << " already used as a template name!"
#006 << llendl;
#007 }
#008 mMessageTemplates[templatep->mName] = templatep;
#009 mMessageNumbers[templatep->mMessageNumber] = templatep;
#010 }

这里的mMessageTemplates和mMessageNumbers是使用stl库里的map来实现的，这样可以实现快速查找到消息结构定义。由于map是快速的红黑树实现，因此查找起来的速度是非常快的。在解包的过程中只要给出MessageNumber，就可以快速地定位到这个数据包的组成，这样就可以检验这个数据包是否合法，同时读取这个消息包的字段信息。