Home · All Classes · Modules  · QSS HELP  · QSS 案例 · VER007 HOME

QXmlSerializer Class Reference
^{[QtXmlPatterns module]}

该QXmlSerializer类是一个实现QAbstractXmlReceiver转化XQuery输出为未格式化的XML 。More...

继承QAbstractXmlReceiver。

通过继承QXmlFormatter。

Methods

• __init__ (self, QXmlQuery query, QIODevice outputDevice)
• atomicValue (self, QVariant value)
• attribute (self, QXmlName name, QStringRef value)
• characters (self, QStringRef value)
• QTextCodec codec (self)
• comment (self, QString value)
• endDocument (self)
• endElement (self)
• endOfSequence (self)
• namespaceBinding (self, QXmlName nb)
• QIODevice outputDevice (self)
• processingInstruction (self, QXmlName name, QString value)
• setCodec (self, QTextCodec codec)
• startDocument (self)
• startElement (self, QXmlName name)
• startOfSequence (self)

Detailed Description

该QXmlSerializer类是一个实现QAbstractXmlReceiver转化XQuery输出为未格式化的XML 。

QXmlSerializer的翻译XQuery sequence，一个通常的输出QXmlQuery，转换成XML 。考虑例子：

 QXmlQuery query;
 query.setQuery("doc('index.html')/html/body/p[1]");

 QXmlSerializer serializer(query, myOutputDevice);
 query.evaluateTo(&serializer);

首先它构造一个query这会从文档的第一段index.html。然后，它会构造这个类的一个实例与query和myOutputDevice。最后，它evaluates该query，产生呼叫到串行器的回调函数的有序序列。回调的序列转换查询输出到XML ，并将其写入到myOutputDevice。

QXmlSerializer将：

• Declare namespaces when needed,
• Use appropriate escaping, when characters can't be represented in the XML,
• Handle line endings appropriately,
• Report errors, when it can't serialize the content, e.g., when asked to serialize an attribute that is a top-level node, or when more than one top-level element is encountered.

如果序列化过程中发生错误，结果是不确定的，除非该串行器通过调用驱动QXmlQuery.evaluateTo（ ） 。

如果生成的XML应当缩进和格式化的阅读，使用QXmlFormatter。

Method Documentation

QXmlSerializer.__init__ (self, QXmlQuery query, QIODevice outputDevice)

构造一个使用的名称游泳池和消息处理程序序列化query，并写入到输出outputDevice。

outputDevice必须是有效的，非空的设备处于写模式打开，否则行为是未定义的。

outputDevice不得开QIODevice.Text因为这将导致输出不正确。本课程将确保行结束被序列化为符合XML规范。QXmlSerializer不采取所有权outputDevice。

QXmlSerializer.atomicValue (self, QVariant value)

从重新实现QAbstractXmlReceiver.atomicValue（ ） 。

QXmlSerializer.attribute (self, QXmlName name, QStringRef value)

QXmlSerializer.characters (self, QStringRef value)

从重新实现QAbstractXmlReceiver.characters（ ） 。

QTextCodec QXmlSerializer.codec (self)

返回正在使用的序列，它的XML输出编码的编解码器。

See also setCodec（ ） 。

QXmlSerializer.comment (self, QString value)

从重新实现QAbstractXmlReceiver.comment（ ） 。

QXmlSerializer.endDocument (self)

从重新实现QAbstractXmlReceiver.endDocument（ ） 。

QXmlSerializer.endElement (self)

从重新实现QAbstractXmlReceiver.endElement（ ） 。

QXmlSerializer.endOfSequence (self)

从重新实现QAbstractXmlReceiver.endOfSequence（ ） 。

QXmlSerializer.namespaceBinding (self, QXmlName nb)

从重新实现QAbstractXmlReceiver.namespaceBinding（ ） 。

QIODevice QXmlSerializer.outputDevice (self)

将指针返回到输出设备。没有相应的功能，以set输出设备，因为输出设备必须传递给构造函数。该串行器并不需要它的IO设备的所有权。

QXmlSerializer.processingInstruction (self, QXmlName name, QString value)

从重新实现QAbstractXmlReceiver.processingInstruction（ ） 。

QXmlSerializer.setCodec (self, QTextCodec codec)

设置编解码器串行器将用于其XML输出编码。输出的编解码器被设置为outputCodec。默认情况下，输出的编解码器被设置为一个用于UTF-8。该串行器并不需要编解码器的所有权。

See also codec（ ） 。

QXmlSerializer.startDocument (self)

从重新实现QAbstractXmlReceiver.startDocument（ ） 。

QXmlSerializer.startElement (self, QXmlName name)

从重新实现QAbstractXmlReceiver.startElement（ ） 。

QXmlSerializer.startOfSequence (self)

从重新实现QAbstractXmlReceiver.startOfSequence（ ） 。