现在的位置: 首页 > 自动控制 > 工业·编程 > 正文

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

2020-04-17 09:09 工业·编程 ⁄ 共 3566字 ⁄ 字号 评论 1 条

上一节介绍了控件构造器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;

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

目前有 1 条留言    访客:0 条, 博主:0 条 ,引用: 1 条

    外部的引用: 1 条

    • Duilib源码分析(四)绘制管理器—CPaintManagerUI—(前期准备一) | 求索阁

    给我留言

    留言无头像?