xml提供了不同或不相似的系统之间表达或交流信息的功能强大和灵活的方式。xml也是基于文本格式的,它在许多方面与html相似。例如,xml文档中也包含有开始(例如<font>)、结束(例如</font>)标志。与html不同的是,我们可以在xml中使用任何喜欢的标志━━使用多少标志或如何给它们命名都由我们自己来定。
mxxmlwriter组件基础知识
创建xml文档的最大困难在于,xml文档应该符合一些基本的格式规则━━例如确保其中的元素不会重迭。尽管我们可以很容易地保证新的xml文档符合xml规格所定义的基本格式,但使用第三方的组件来管理它的输出会更加简单和安全。在本篇文章中我们将介绍的是mxxmlwriter,它是微软的ms xml parser 3.0的一部分。
说起解析器,我们一般会想到在其输入端需要输入一些数据,然后在其输出端得到一系列的符号。微软的xml parser与规则解析器的作用非常相似,它在输入端接受一个xml文档,然后在输出端生成一个xml文档对象模型(dom)━━xml文档的一种基于对象的表达方式,或者生成一系列的simple api for xml(sax)事件。无论生成哪种输出格式,其输入都是xml文档。
mxxmlwriter是微软xml parser的一部分,对于通过编程方式创建xml文档非常有用。使用mxxmlwriter比自己动手创建xml文档有许多好处,其中包括:
·mxxmlwriter产生的xml文档符合w3c xml 1.0 namespace推荐标准,我们无需关心输出格式,因为解析器能够为我们解决这一切。
·我们可以将mxxmlwriter的输出与sax content handler绑定在一块儿,以较少的内存快速进行处理。
·基于界面的编程模式使我们的代码更容易阅读和维护,我们可以将输出发送给一个支持istream界面的string或com对象。
处理xml文档的基础知识
在能够使用mxxmlwriter组件创建新的xml文档之前,我们需要了解一些处理xml文档的基本知识,因为mxxmlwriter希望使用它的应用程序能够成为sax事件提供者。
处理xml文档有二种方式:使用文档对象模型(dom)或者simple api for xml(sax)。二种方法在各种应用中各有优、缺点,dom在xml文档查询方面有优势,sax在快速处理超大型xml文档方面有优势,而且能够使我们完全控制解析的过程。
使用dom处理xml文档
当将xml文档加载至dom中时,xml解析器会读取整个文档,在内存中创建许多表达这一文档的对象。下面的图1显示了一个简单的xml文档片段和dom如何在内存中表示它:
图1显示,document类的实例表示一个xml文档(图1中的第一部分),xml文档中包含有节点(图1中的第二部分),这些节点是dom node对象的实例。(图1中的第三部分)。
一旦dom已经将全部xml文档读入内存,dom就为你处理xml文档作好所有的准备了。我们可以通过使用循环重复处理其中的内容、使用xpath表达式查询特定的节点或随机访问dom树的任意部分对dom中的元素进行操作。关健是我们的应用程序能够对xml文档进行完整的控制,可以从文档在内存中的表示中提取所需要的信息。
使用sax处理xml文档
sax编程模式与dom编程模式完全不同。通过让应用程序截获xml解析器在处理xml文档时产生的事件,sax可以使应用程序更接近xml解析器。由于事件是被推送到应用程序中的,因此,它提供的是一种“推”编程模式,应用程序无需象在使用dom时那样作为一个控制点。
,xml reader(图2中的第一部分)负责读取xml文档。xml reader请求了我们提供的一个组件,它在读取xml文档时调用了其界面中的方法。(图2中的第二部分)我们的应用程序(图2中的第三部分)则使用组件的输出。
在图2中,一个包含有isaxxmlreader的组件被用作xml reader。要使用sax处理xml文档,需要在isaxcontenthandler界面中注册一个组件。当xml reader遇到文档中的元素时,它调用isaxcontenthandler方法处理startdocument、startelement等元素和提供有关xml reader读取的元素信息的字符。图3显示了一个事件的序列,该事件序列是xml reader在处理样例文件(图1、2中出现的)时生成的。
使用mxxmlwriter创建xml文档
mxxmlwriter是sax的消费者,意味着使用mxxmlwriter的应用程序是sax的提供者,mxxmlwriter使用sax事件编写出正确格式的xml文档。
本篇文章中的例子代码是一个能够读取以“,”分割的文件并产生xml文档的控制台应用程序,它产生的xml文档显示在屏幕上,我们可以将其输出捕捉到文本文件中,并保存在磁盘上。例子代码使用stl(标准模板库)对文件的读取进行管理。下面的表1显示了mxxmlwriter的具体代码,它能够建立指向isaxcontenthandler等界面的指针:
listing 1 – instanciating mxxmlwriter// msxml2::imxwriterptr是一个智能化指针
msxml2::imxwriterptr pxmlwriter;
pxmlwriter.createinstance(__uuidof(msxml2::mxxmlwriter));
// isaxcontenthandler是一个由mxxmlwriter使用的界面
msxml2::isaxcontenthandlerptr pcontenthandler;
pcontenthandler=pxmlwriter; //calls qi for isaxcontenthandler on pxmlwriter
//isaxerrorhandler是一个由mxxmlwriter使用的界面
msxml2::isaxerrorhandlerptr perrorhandler;
perrorhandler=pxmlwriter; //calls qi for isaxerrorhandler on pxmlwriter
// isaxdtdhandler也是由mxxmlwriter使用的界面
msxml2::isaxdtdhandlerptr pdtdhandler;
pdtdhandler=pxmlwriter; //calls qi for isaxdtdhandler on pxmlwriter
//将输出内容输出到一个字符串中
pxmlwriter->put_output(ccomvariant(l""));
一旦mxxmlwriter完成了,程序就会读取文本文件,并生成供mxxmlwriter处理的sax事件。程序如下面的表2所示:
表2:生成供mxxmlwriter使用的事件
std::getline(filein,linefromfile);
while(filein.good())
{
npos=linefromfile.find_first_of(",",nlast);
//确定当前行有一个“,”号;
//如果没有发现,find_first_of返回std::wstring::npos
if(npos!=std::wstring::npos){
welementname=a2w(linefromfile.substr(nlast,npos-nlast).c_str());
// startelement元素
pcontenthandler->startelement(l"",0,l"",0,
const_cast<wchar_t*>(welementname.c_str()),
welementname.length(),null);
nlast= ++npos;
// 获取当前行的其他部分(元素值)
welementvalue=a2w(linefromfile.substr(nlast).c_str());
// 字符
pcontenthandler->characters(
const_cast<wchar_t*>(welementvalue.c_str()),
welementvalue.length());
// endelement元素
pcontenthandler->endelement(l"",0,l"",0,
const_cast(welementname.c_str()),
welementname.length());
}
std::getline(filein,linefromfile);
nlast=0;
}
上面的程序置于一个由输入文件的状态控制的循环中,它使用std::getline(…)方法逐行读取输入文件,并将读取的行存储在std::string类型变量linefromfile中。mxxmlwriter期望的输入数据类型为unicode字符串,程序使用ansi字符串使文档的解析更简单。这样,程序在把从文件中读取的ansi字符串在传递给mxxmlwriter之前才转换为unicode字符串。
输入文件是文本文件,每行中包括一个元素和元素值对儿。程序代码能够对由元素和元素值对组成的xml文档进行处理。
表3:样例文本文件
author, essam ahmed
topic, using the microsoft xml parser…
author, essam ahmed
topic, using the microsoft xml parser…
<?xml version="1.0" encoding="utf-16" standalone="no"?>
<rootelement>
<author>essam ahmed</author>
<topic>using the microsoft xml parser…</topic>
</ rootelement>
程序把其输出内容输出到屏幕上,如果想把输出保存在文件中,可以使用重定向符>将输出内容输出到一个文件中。
结束语
这篇文章介绍了如何使用microsoft xml 3.0 parser中的一个组件━━mxxmlwriter来创建xml文档。使用mxxmlwriter比自己编写类似的代码有几点好处,它不但符合现有的标准,而且在标准改变时也无需升级自己的代码。