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 。考虑例子：

  1.  [QXmlQuery]($docs-qxmlquery.html) query;
  2.  query.setQuery("doc('index.html')/html/body/p[1]");
  4.  QXmlSerializer serializer(query, myOutputDevice);
  5.  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

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

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

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

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

  1. QXmlSerializer.atomicValue (self, QVariant value)

从重新实现QAbstractXmlReceiver.atomicValue（ ） 。

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

从重新实现QAbstractXmlReceiver.characters（ ） 。

  1. QTextCodec QXmlSerializer.codec (self)

[

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

]($docs-qtextcodec.html)

See also setCodec（ ） 。

  1. QXmlSerializer.comment (self, QString value)

从重新实现QAbstractXmlReceiver.comment（ ） 。

  1. QXmlSerializer.endDocument (self)

从重新实现QAbstractXmlReceiver.endDocument（ ） 。

  1. QXmlSerializer.endElement (self)

从重新实现QAbstractXmlReceiver.endElement（ ） 。

  1. QXmlSerializer.endOfSequence (self)

从重新实现QAbstractXmlReceiver.endOfSequence（ ） 。

  1. QXmlSerializer.namespaceBinding (self, QXmlName nb)

从重新实现QAbstractXmlReceiver.namespaceBinding（ ） 。

  1. QIODevice QXmlSerializer.outputDevice (self)

[

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

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

]($docs-qiodevice.html)

从重新实现QAbstractXmlReceiver.processingInstruction（ ） 。

  1. QXmlSerializer.setCodec (self, QTextCodec codec)

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

See also codec（ ） 。

  1. QXmlSerializer.startDocument (self)

从重新实现QAbstractXmlReceiver.startDocument（ ） 。

  1. QXmlSerializer.startElement (self, QXmlName name)

从重新实现QAbstractXmlReceiver.startElement（ ） 。

  1. QXmlSerializer.startOfSequence (self)

从重新实现QAbstractXmlReceiver.startOfSequence（ ） 。