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

QXmlSimpleReader Class Reference
^{[QtXml module]}

该QXmlSimpleReader类提供了一个简单的XML解析器的实现。More...

继承QXmlReader。

Methods

• __init__ (self)
• QXmlContentHandler contentHandler (self)
• QXmlDeclHandler declHandler (self)
• QXmlDTDHandler DTDHandler (self)
• QXmlEntityResolver entityResolver (self)
• QXmlErrorHandler errorHandler (self)
• (bool, bool ok) feature (self, QString name)
• bool hasFeature (self, QString name)
• bool hasProperty (self, QString name)
• QXmlLexicalHandler lexicalHandler (self)
• bool parse (self, QXmlInputSource input)
• bool parse (self, QXmlInputSource input, bool incremental)
• bool parseContinue (self)
• (sip.voidptr, bool ok) property (self, QString name)
• setContentHandler (self, QXmlContentHandler handler)
• setDeclHandler (self, QXmlDeclHandler handler)
• setDTDHandler (self, QXmlDTDHandler handler)
• setEntityResolver (self, QXmlEntityResolver handler)
• setErrorHandler (self, QXmlErrorHandler handler)
• setFeature (self, QString name, bool value)
• setLexicalHandler (self, QXmlLexicalHandler handler)
• setProperty (self, QString name, sip.voidptr value)

Detailed Description

该QXmlSimpleReader类提供了一个简单的XML解析器的实现。

这个XML阅读器是适用于广泛的应用范围。它能够解析格式良好的XML ，并可以报告元素的命名空间的内容处理程序，但是，它不解析任何外部实体。由于历史的原因，属性值规范化和最终的线在不执行1.0规范的XML描述的处理。

使用这个类的最简单的模式是创建一个读取器实例，定义一个输入源，指定要使用的阅读器的处理程序，并解析数据。

例如，我们可以使用一个QFile提供输入。这里，我们创建了一个阅读器，并定义要使用的读取器输入源：

     QXmlSimpleReader xmlReader;
     QXmlInputSource *source = new QXmlInputSource(file);

处理程序可以让我们执行操作时，读写器遇到某些类型的内容，或者如果被发现的输入错误。读者必须被告知要使用的每种类型的事件的处理程序。对于许多常见的应用，我们可以通过继承创建一个自定义处理程序QXmlDefaultHandler，并以此来处理错误和内容的事件：

     Handler *handler = new Handler;
     xmlReader.setContentHandler(handler);
     xmlReader.setErrorHandler(handler);

如果你不至少设置的内容和错误处理程序，解析器会回到属于它的默认行为---并不会做任何事。

最方便的方法来处理输入是用来阅读它在一个单一的通行证parse（有一个参数，指定输入源）函数：

     bool ok = xmlReader.parse(source);

     if (!ok)
         std.cout << "Parsing failed." << std.endl;

如果您无法解析整个输入一次过（例如，它是巨大的，或者被传递通过网络连接） ，数据可以在块被送入分析器。这是通过告诉实现parse（ ）以增量方式工作，使得后续调用parseContinue（）函数，直到所有的数据已经被处理。

执行增量分析的一种常用方法是连接readyRead()的一个信号network reply一个时隙，并且有处理接收的数据。看QNetworkAccessManager。

解析行为的某些方面可以用适应setFeature（）和setProperty（ ） 。

 xmlReader.setFeature("http://xml.org/sax/features/namespace-prefixes", true);

QXmlSimpleReader是不可重入的。如果你想使用这个类在线程代码，使用QXmlSimpleReader具有锁定机构，如锁码QMutex。

Method Documentation

QXmlSimpleReader.__init__ (self)

构造一个简单的XML阅读器。

QXmlContentHandler QXmlSimpleReader.contentHandler (self)

从重新实现QXmlReader.contentHandler（ ） 。

See also setContentHandler（ ） 。

QXmlDeclHandler QXmlSimpleReader.declHandler (self)

从重新实现QXmlReader.declHandler（ ） 。

See also setDeclHandler（ ） 。

QXmlDTDHandler QXmlSimpleReader.DTDHandler (self)

从重新实现QXmlReader.DTDHandler（ ） 。

See also setDTDHandler（ ） 。

QXmlEntityResolver QXmlSimpleReader.entityResolver (self)

从重新实现QXmlReader.entityResolver（ ） 。

See also setEntityResolver（ ） 。

QXmlErrorHandler QXmlSimpleReader.errorHandler (self)

从重新实现QXmlReader.errorHandler（ ） 。

See also setErrorHandler（ ） 。

(bool, bool ok) QXmlSimpleReader.feature (self, QString name)

从重新实现QXmlReader.feature（ ） 。

See also setFeature（ ） 。

bool QXmlSimpleReader.hasFeature (self, QString name)

从重新实现QXmlReader.hasFeature（ ） 。

bool QXmlSimpleReader.hasProperty (self, QString name)

从重新实现QXmlReader.hasProperty（ ） 。

QXmlLexicalHandler QXmlSimpleReader.lexicalHandler (self)

从重新实现QXmlReader.lexicalHandler（ ） 。

See also setLexicalHandler（ ） 。

bool QXmlSimpleReader.parse (self, QXmlInputSource input)

从重新实现QXmlReader.parse（ ） 。

bool QXmlSimpleReader.parse (self, QXmlInputSource input, bool incremental)

从重新实现QXmlReader.parse（ ） 。

读取从XML文档input并分析它在一次通过（非增量） 。返回True如果解析成功，否则返回False 。

bool QXmlSimpleReader.parseContinue (self)

继续增量分析，从获取输入QXmlInputSource这是与最近一次调用中指定parse（ ） 。要使用此功能，您must呼吁parse（）设置为True增量参数。

如果发生解析错误，则返回False ，否则返回True ，即使XML文件的结尾还没有达到。您可以通过再次调用这个函数当有可用来分析更多的数据继续分析在后一阶段。

调用此函数时，有一个在输入源中没有数据表明该XML文件的末尾已到达读者。如果提供了该点的输入是没有很好地形成则发生解析错误，并返回False 。如果提供的输入是良好的，则返回True 。它结束的输入以这种方式，因为它允许您重用读者解析其他XML文件是很重要的。

调用此函数文件的末尾已到达之后，但没有可用的数据会导致错误要返回前一个输入是否是格式良好的或没有。

See also parse（ ）QXmlInputSource.data（）和QXmlInputSource.next（ ） 。

(sip.voidptr, bool ok) QXmlSimpleReader.property (self, QString name)

从重新实现QXmlReader.property（ ） 。

See also setProperty（ ） 。

QXmlSimpleReader.setContentHandler (self, QXmlContentHandler handler)

从重新实现QXmlReader.setContentHandler（ ） 。

See also contentHandler（ ） 。

QXmlSimpleReader.setDeclHandler (self, QXmlDeclHandler handler)

从重新实现QXmlReader.setDeclHandler（ ） 。

See also declHandler（ ） 。

QXmlSimpleReader.setDTDHandler (self, QXmlDTDHandler handler)

从重新实现QXmlReader.setDTDHandler（ ） 。

QXmlSimpleReader.setEntityResolver (self, QXmlEntityResolver handler)

从重新实现QXmlReader.setEntityResolver（ ） 。

See also entityResolver（ ） 。

QXmlSimpleReader.setErrorHandler (self, QXmlErrorHandler handler)

从重新实现QXmlReader.setErrorHandler（ ） 。

See also errorHandler（ ） 。

QXmlSimpleReader.setFeature (self, QString name, bool value)

从重新实现QXmlReader.setFeature（ ） 。

打开该功能name如果enable为True，否则将其关闭。

该name参数必须是下列字符串之一：

See also feature（ ）hasFeature（）和SAX2 Features。

QXmlSimpleReader.setLexicalHandler (self, QXmlLexicalHandler handler)

从重新实现QXmlReader.setLexicalHandler（ ） 。

See also lexicalHandler（ ） 。

QXmlSimpleReader.setProperty (self, QString name, sip.voidptr value)

从重新实现QXmlReader.setProperty（ ） 。

See also property（ ） 。