Duilib源码分析(三)XML解析器—CMarkup

　　上一节介绍了控件构造器CDialogBuilder，接下来将分析其XML解析器CMarkup；

　　CMarkup：xml解析器，目前内置支持三种编码格式:UTF8、UNICODE、ASNI，默认为UTF8；CMarkupNode：xml节点类

　　先介绍CMarkup：

　　XMLELEMENT: xml节点元素类型定义，iStart，节点元素在xml文件中的起始位置；iChild，节点元素子节点；iNext，节点元素的下一个节点(兄弟节点)；iParent，节点元素的父节点；iData，

　　节点元素的数据(事实上，这些值均为ULONG类似，即unsigned long;存储的值为当前数据在内存缓冲区m_pstrXML中指向的位置)。

　　CMarkupNode作为CMarkup的友元类，意味着可以访问CMarkup的各成员函数和数据属性，事实上后期的遍历xml就是结合CMarkupNode的GetSibling和GetChild实现的。

　　类成员数据：

　　　　m_pstrXML：为CMarkup存储的以加载xml文件数据内容的指针缓冲区；

　　　　m_pElements：保存XMLELEMENT类型的节点元素信息的缓冲区，事实上可能有部分未预料的存储空间；

　　　　m_nElements：实际的保存m_pElements中有效的节点元素数；

　　　　m_nReservedElements：预留的m_pElements缓冲区空间大小，具体策略为：m_nElements >= m_nReservedElements ) {m_nReservedElements += (m_nReservedElements / 2)

　　　　　　　　　　　　　　　　 + 500;m_pElements = static_cast<XMLELEMENT*>(realloc(m_pElements, m_nReservedElements * sizeof(XMLELEMENT)));

　　　　m_szErrorMsg：最近一次解析时的错误信息；

　　　　m_szErrorXML：最近一次解析时的xml位置信息；

　　　　m_bPreserveWhitespace：是否跳过忽略空格，默认是忽略；

　　类成员函数：

　　　　Load：通过参数pstrXML，传入xml文件内容的方式解析，内部主要是分配m_pstrXML缓冲区并拷贝pstrXML内容，后通过_Parse解析；

　　　　LoadFromMem：通过加载内存资源方式解析，内部通过宏处理时限宽字节unicode和多字节编译时定义处理解析，最终也是分配m_pstrXML缓冲区并拷贝该内存数据内容，后通过_Parse解析；

　　　　LoadFromFile：通过参数pstrFilename文件路径名，可以是xml文件或是压缩文件(内部为xml文件)，对于xml文件或是压缩文件处理读取内部数据至临时内存缓冲区中(解压缩采用的是ZIP_INFO

　　　　的cpp实现方式便于接口调用，参见duilib目录文件XUnzip.cpp)并再次通过调用LoadFromMem加载解析；

　　　　Release：主要用以释放m_pstrXML和m_pElements缓冲区资源；

　　　　IsValid：当前解析是否有效，通过m_pElements != NULL判断；

　　　　SetPreserveWhitespace：设置m_bPreserveWhitespace是否忽略解析中字符串的空格，

　　　　GetLastErrorMessage：获取m_szErrorMsg的最近一次解析时的错误信息；

　　　　GetLastErrorLocation：获取m_szErrorXML的最近一次解析时的xml位置信息；

　　　　GetRoot：获取根节点CMarkupNode，CMarkupNode(this, 1)，以当前为第一个节点的节点对象；

　　　　_ReserveElement：分配足够的预留空间；

　　　　_Parse：分配预留空间、初始化m_szErrorMsg、m_szErrorXML，并调用重载函数_Parse，执行真正的解析过程；

　　　　_SkipWhitespace：重载版本均处理、跳过字符串空格；

　　　　_SkipIdentifier：重载版本均均处理、跳过标志符号如：‘_’， ‘:’ ;

　　　　_ParseData：解析元素属性中数据；

　　　　_ParseMetaChar：解析元字符，如：'&', '<','>','\"','\'','&'与'a', 'm', 'p', 't', ';'等相关组合字符串；

　　　　_ParseAttributes：解析元素属性；

　　　　_Failed：保存解析中产生最近一次的错误信息、位置，m_szErrorMsg、m_szErrorXML；

　　接下来CMarkupNode:

　　XMLATTRIBUTE：节点属性结构体定义，iName为属性名，iValue为属性值均为ULONG类型；

　　MAX_XML_ATTRIBUTES：节点支持最多64个属性个数；

　　类成员数据：

　　　　m_aAttributes：节点属性列表(节点属性数组,保存数据类似于键值对的方式)；

　　　　m_iPos：指定该属性节点在所属拥有者(指CMarkup对象)中的节点元素中的当前位置(事实上其节点元素也为指针数组保存)；

　　　　m_nAttributes：节点中属性数；

　　　　m_pOwner：该节点所属拥有者(指CMarkup对象)；

　　类成员函数：

　　　　CMarkupNode：重载版构造函数，其中一个以CMarkup对象和当前所属节点所在位置初始化m_iPos；

　　　　IsValid：当前节点是否有效，其通过m_pOwner != NULL判断；

　　　　GetParent：获取当前节点的父节点node，事实上是通过创建一个CMarkupNode(m_pOwner, iPos)，作为其父节点，iPos为当前节点的iParent值；

　　　　GetSibling：获取当前节点的下一个节点(兄弟节点)，同GetParent一样，iPos为当前节点的iNext值；

　　　　GetChild：获取当前节点的子节点，iPos为当前节点的iChild值；另外重载版本GetChild，参数为pstrName，遍历当前节点所有子节点与pstrName匹配的节点；

　　　　HasSiblings：是否有兄弟节点；

　　　　HasChildren：是否有子节点；

　　　　GetName：获取当前节点名字；

　　　　GetValue：获取当前节点值；

　　　　HasAttributes：当前节点是否有属性，通过m_nAttributes > 0判断；其重载版本HasAttribute，参数pstrName，判断遍历当前节点的所有属性有与pstrName匹配的；

　　　　GetAttributeCount：同HasAttributes，通过m_nAttributes判断；

　　　　GetAttributeName：获取属性名，参数iIndex为指定的属性索引；

　　　　GetAttributeValue：获取属性值，有四个重载版本，其中一个版本为参数iIndex，属性索引；一个版本pstrName参数为属性名；另外两个版本差不多，只是返回值以输入输出参；

　　　　_MapAttributes：最为核心的属性映射处理函数，内部主要遍历解析当前节点中各属性及值，并存入m_aAttributes中并更新m_nAttributes值；

 　　最后说明：

　　　　1. 从代码中可以看出，CMarkup存储了一份整个文件的内容，另外也保存了各个元素节点，并未对各个元素节点的属性单独存储，即并未存储CMarkupNode；

　　　　　此外在源码中可以看出很多操作都会执行_MapAttributes，好在该遍历映射不会很大，控制在最多64个属性；

　　　　2. 加载zip压缩资源文件时，可以使用CachedResourceZip缓存资源，也可以直接使用的是ZIP-INFO的CPP版本(一个文件)，使用到被宏重定义的接口：OpenZip、FindZipItem、UnzipItem、

　　　　　CloseZip；具体使用可参考XUnzip.cpp接口；默认使用的是OpenZip加载压缩资源文件。

　　还记得源码分析(一)一节中，HandleMessage处理函数中消息WM_CRAETE处理过程吗？

　　　　1. CDialogBuilder构建各控件对象并形成控件树，并返回第一个控件对象pRoot；

　　　　2. m_pm.AttachDialog(pRoot);m_pm.AddNotifier(this)；将控件attach到CPaintManagerUI  m_pm中管理，此外INotifyUI子类对象被加入到m_pm；这样m_pm不仅管理控件对象

　　　　　也对消息监听接口Notify回调，这样用户可以在Notify中实现自己的感兴趣的消息映射处理，其Notify(TNotifyUI& msg)中的参数为通告消息msg；

　　事实上我们主要需要弄清楚三点：一是如何绘制、二是数据如何处理、三是消息如何流转；接下来下一节将对控件绘制和消息流转进行分析。

　　

　　　　

　　　　

　　　　

　　　　

转载于:https://www.cnblogs.com/haomiao/p/4925273.html