一、方法概述
能读取XML文件的应用程序多数也需要写入XML文件。一般来说,主要有三种由Qt应用程序生成XML文件的方法:
- 使用QXmlStreamWriter。
- 构建DOM树并对它调用save()。
- 手动生成XML。
使用QXmlStreamWriter是目前最简单易行的方式,同时它也比手动生成XML文档更加可靠。使用DOM生成XML的方法,在DOM树已作为应用程序的基本数据结构时才真正有意义。
二、使用QXmlStreamWriter写入XML
利用QXmlStreamWriter类来写人XML文件非常容易,因为它将时刻为我们关注那些特殊的转义字符。如果想利用QXmlStreamWriter从QTreeWidget中输出书刊索引数据,只需要使用两个函数。
第一个函数获得文件名和一个QTreeWidget*,并且将遍历树中所有的顶级项:
bool writeXml(const QString &fileName,QTreeWidget *treeWidget)
{
QFile file(fileName);
if(!file.open(QFile::WriteOnly | QFile::Text)){
std::cerr<<"Error: Cannot write file "
<<qPrintable(fileName)<<": "
<<qPrintable(file.errorString())<<std::endl;
return false;
}
QXmlStreamWriter xmlWriter(&file);
xmlWriter.setAutoFormatting(true);
xmlWriter.writeStartDocument();
xmlWriter.writeStartElement("bookindex");
for(int i=0;i<treeWidget->topLevelItemCount();i++){
writeIndexEntry(&xmlWriter,treeWidget->topLevelItem(i));
}
xmlWriter.writeEndDocument();
file.close();
if(file.error()){
std::cerr<<"Error: Cannot write file "
<<qPrintable(fileName)<<": "
<<qPrintable(file.errorString())<<std::endl;
return false;
}
return true;
}
如果开启了自动格式编辑功能,XML文档将以更友好易读的格式输出,在每一行都有明确显示数据递归结构的缩进。writeStartDocument()函数则写下XML文档首行:
<?xml version="1.0" encoding="UTF-8"?>
writeStartElement()函数随给定的标签文本生成一个新的开始标签。writeEndDocument()函数则关闭任何打开的开始标签。对于每一个顶级项,我们调用writelndexEntry()函数,并将QXmlStreamWriter和要输出的项传递给writelndexEntry()函数。下面是writelndexEntry()的代码:
void writeIndexEntry(QXmlStreamWriter *xmlWriter,QTreeWidgetItem *item)
{
xmlWriter->writeStartElement("entry");
xmlWriter->writeAttribute("term",item->text(0));
QString pageString=item->text(1);
if(!pageString.isEmpty()){
QStringList pages=pageString.split(", ");
foreach(QString page,pages){
xmlWriter->writeTextElement("page",page);
}
}
for(int i=0;i<item->childCount();i++){
writeIndexEntry(xmlWriter,item->child(i));
}
xmlWriter->writeEndElement();
}
writelndexEntry()函数创建一个对应于QTreeWidgetItem的<entry>元素并将其作为参数接收。writeAttributes()函数则为刚刚写入的标签添加一个属性。例如,它可以将<entry>转变为<entry term=”sidebearings”>。如果其中有页码,那么页码将以逗号-空格分隔并且对于每一个页码数会有一个单独的<page>…</page>标签对与其间的页码文本一起被写入。这些都可以通过调用writeTextElement()以及将标签名以及开始和结束标签之间的文本传递给writeTextElement()来实现。在说有的情况下,QXmlSteamWriter都考虑了特殊的XML转义字符的处理,我们不必为此担心。
如果项目中有子项,就对每一个子项递归调用writeIndexEntry()。最后,我们调用writeEndElement()来输出</entry>。
三、使用DOM树写入XML
使用QXmlStreamWriter是写如XML文档最容易、最安全的方式,但如果已经在一个DOM树中有XML文档的话,则只需要在QDomDocument对象上调用save()函数并要求这个DOM树输出相关的XML即可。默认情况下,save()使用UTF-8作为所生成文件的编码方式。我们可以通过为树预先进行<?xml?>声明,而使用其他种类的编码方式。例如:
<?xml version=“1.0” encoding=“ISO-8859-1"?>
下面的代码段给出了其完成过程:
bool writeXml(const QString &fileName,QDomDocument *doc)
{
const int Indent=4;
QFile file(fileName);
if(!file.open(QFile::WriteOnly | QFile::Text)){
std::cerr<<"Error: Cannot write file "
<<qPrintable(fileName)<<": "
<<qPrintable(file.errorString())<<std::endl;
return false;
}
QTextStream out(&file);
QDomNode xmlNode=doc->createProcessingInstruction("xml",
"version=\"1.0\" encoding=\"ISO-8859-1\"");
doc->insertBefore(xmlNode,doc->firstChild());
doc->save(out,Indent);
file.close();
if(file.error()){
std::cerr<<"Error: Cannot write file "
<<qPrintable(fileName)<<": "
<<qPrintable(file.errorString())<<std::endl;
return false;
}
return true;
}
从Qt 4.3开始,一个替代的方式就是利用setCodec()函数对QTextStream设置编码,并将QDomNode::EncodingFromTextStream作为第三个参数传递给save()。
四、手动写入XML
手动生成XML文件并不比利用DOM生成XML文件更加困难。我们可以使用QTextStream并且写入字符串,就像写入其他任何文本文件一样。最需要慎重对待的部分就是转义在文本和属性值中的特殊字符。Qt::escape()函数可以转义“<”,“>”和“&”等特殊字符。以下是一个使用它的代码:
QTextStream out(&file);
out.setCodec("UTF-8");
out<<"<doc>\n"
<<" <quote>"<<Qt::escape(quoteText)<<"</quote>\n"
<<" <translation>"<<Qt::escape(translationText)
<<"</translation>\n"
<<"</doc\n";
当采用这样的方式生成XML文件时,除了必须写人正确的<?xml?>声明并设置正确的编码外,还必需记得对写如的文本进行转义。如果使用了属性值,还必须转义其中的单引号和双引号。不过,使用QXmlStreamWriter就会简单得多了,因为它将为我们处理上述所需注意的一切。
——————————————————
对于本文实例完整代码有需要的朋友,可关注并在评论区留言!