|
Home · All Classes · Modules · QSS HELP · QSS 案例 · VER007 HOME |
该QXmlQuery类执行的XQuery查询XML数据，或仿照看起来像XML的非XML数据。More...
该QXmlQuery类执行的XQuery查询XML数据，或仿照看起来像XML的非XML数据。
该QXmlQuery类编译和执行写入查询XQuery language。 QXmlQuery通常是用来查询XML数据，但它也可以查询已仿照看起来像XML的非XML数据。
使用QXmlQuery查询XML数据，如下面的代码片段，很简单，因为它可以使用内置的XML data model作为其代表来遍历数据基础查询引擎。在指定了内置的数据模型XQuery 1.0 and XPath 2.0 Data Model。
QXmlQuery query; query.setQuery("doc('index.html')/html/body/p[1]"); QXmlSerializer serializer(query, myOutputDevice); query.evaluateTo(&serializer);
该示例使用QXmlQuery来匹配XML文档的第一个段落，然后output the result到设备为XML。
使用QXmlQuery查询non-XML数据需要写入的子类QAbstractXmlNodeModel作为替换为内置的XML数据模型的使用。自定义数据模型将能够遍历非XML数据所要求的QAbstractXmlNodeModel接口。这个自定义数据模型的实例就变成使用的查询引擎遍历非XML数据的委讬。有关如何使用QXmlQuery查询非XML数据，请参阅文档的一个例子QAbstractXmlNodeModel。
要运行设置与QXmlQuery查询，调用的评价功能之一。
XPath语言是的一个子集XQuery语言，所以运行XPath表达式是一样的运行XQuery查询。通过使用XPath表达式来QXmlQuerysetQuery（ ） 。
运行一个XSLT样式表是喜欢跑步的XQuery，不同之处在于，当你构建你的QXmlQuery ，你必须通过QXmlQuery.XSLT20告诉QXmlQuery解释不管它从得到setQuery（ ）作为XSLT样式表，而不是一个XQuery。您还必须通过调用设置输入文件setFocus（ ） 。
QXmlQuery query(QXmlQuery.XSLT20);
query.setFocus(QUrl("myInput.xml"));
query.setQuery(QUrl("myStylesheet.xsl"));
query.evaluateTo(out);
Note:目前，setFocus（ ）必须被调用before setQuery（ ）使用XSLT时。
另一种方式来运行一个XSLT样式表是使用xmlpatterns命令行实用程序。
xmlpatterns myStylesheet.xsl myInput.xml
Note:对于目前的版本中， XSLT支持应考虑实验。见XSLT conformance了解详情。
样式表参数使用绑定bindVariable（ ） 。
当一个查询被执行的XML数据，如代码段所述，doc()函数返回的内置数据模型，其中的查询评估将开始的节点。但是，当一个查询运行在包含非XML数据的一个自定义节点模型bindVariable（ ）函数必须调用一个变量名绑定到自定义模型的起始节点。澳元变量引用被用在XQuery文字来访问自定义模型的起始节点。这是没有必要声明外部查询中的变量名。参见示例说明文档中的QAbstractXmlNodeModel。
QXmlQuery是可重入的，但不是线程安全的。它是安全使用QxmlQuery拷贝构造函数来创建查询的副本，并执行相同的查询多次。在幕后， QXmlQuery将重用，如打开的文件和编译的查询的资源尽可能。但它是不是安全使用QXmlQuery的同一实例中的多个线程。
可发生在查询计算错误。例子包括错误类型和文件加载错误。当发生错误时：
当查询运行时，它会解析文件，分配内部数据结构来保存它们，则可能在网络上加载其他资源。这时候可能会重复使用这些分配的资源，以避免重新加载并重新分析他们。
When setQuery（）被调用时，该查询的文本被编译成一个内部数据结构，并进行了优化。优化的形式随后可重复用于查询的多个评估。由于编译 - 优化的过程可以是昂贵的，它重复了同样的查询，应避免使用QXmlQuery的一个单独的实例为每个查询文本。
一旦文件被解析，它的内部表示保持在QXmlQuery实例，并在多个QXmlQuery实例共享。
实例QCoreApplication必须存在QXmlQuery才能使用。
当QXmlQuery访问资源（例如，呼叫fn:doc()加载一个文件，或通过绑定变量访问设备） ，事件循环使用，这意味着事件将被处理。为了避免处理事件时， QXmlQuery访问的资源，在一个单独的线程中创建您的QXmlQuery实例。
指定是否要QXmlQuery解释输入到setQuery（）作为XQuery或作为XSLT样式表。
| Constant | Value | Description |
|---|---|---|
| QXmlQuery.XQuery10 | 1 | XQuery1.0 。 |
| QXmlQuery.XSLT20 | 2 | XSLT 2.0的选择，在W3C XML模式1.1的唯一性约束上找到了禁区XPath模式。除了限制的语法，表达式的类型检查阶段假定节点序列成为焦点。领域， W3C XML模式1.1的唯一性约束上找到了禁区XPath模式。除了限制的语法，表达式的类型检查阶段假定节点序列成为焦点。表示的XPath 2.0 。拥有公共API中没有作用，它的内部使用。由于有了XmlSchema11IdentityConstraintSelector和XmlSchema11IdentityConstraintField ，表达式的类型检查阶段假定节点序列成为焦点。 |
这个枚举被引入或修改的Qt 4.5 。
See also setQuery（ ） 。
构造不能使用，直到无效的，空的查询setQuery（）被调用。
Note:如果您打算使用这个这个构造函数必须不能使用QXmlQuery处理XSL -T样式表。其他的构造，必须在这种情况下被使用。
构造一个QXmlQuery即副本other。新的实例将与现有的查询尽可能共享资源。
构建将使用一个查询np正如它的名字池。该查询不能被计算，直到setQuery（ ）被调用。
构建体将被用来执行XQuery查询或XSL -T样式表的查询，这取决于的值queryLanguage。它将使用np正如它的名字池。
Note:如果你的QXmlQuery将处理XSL -T样式表，这个构造函数必须被使用。默认的构造函数只能创建实例QXmlQuery运行的XQuery 。
Note:本新闻稿中的XSL -T的支持，被认为是实验性的。请参阅XSLT conformance了解详情。
此功能被引入Qt的4.5 。
See also queryLanguage（ ） 。
绑定变量name到value使$name可以从查询中用于指代的value。
name必须不null。name。 ISNULL（ ）必须返回False 。如果name已绑定由以前的bindVariable （ ）调用，它以前的绑定将被改写。
If value为null ，这样value。 ISNULL（ ）返回True，name已经有约束力的，效果是消除了现有绑定name。
要绑定类型的值QString or QUrl，包装在一个值QVariant这样，QXmlItem的QVariant构造函数被调用。
由查询处理的所有字符串必须是有效的XQuery字符串，这意味着它们必须只包含XML 1.0字符。然而，这一要求没有被选中。如果查询处理一个无效的字符串，该行为是未定义的。
See also QVariant.isValid（ ）How QVariant maps to XQuery's Data Model和QXmlItem.isNull（ ） 。
绑定变量name到device使$name可以从查询中用于指代的device。该QIODevice device暴露于查询作为类型的URIxs:anyURI，它可以被传递到fn:doc()函数来进行读取。例如，该功能可用于在存储器中通过XML文档来fn:doc。
QByteArray myDocument;
QBuffer buffer(&myDocument); // This is a QIODevice.
buffer.open(QIODevice.ReadOnly);
QXmlQuery query;
query.bindVariable("myDocument", &buffer);
query.setQuery("doc($myDocument)");
调用者必须确保device已被打开，至少QIODevice.ReadOnly在此之前绑定。否则，行为是未定义的。
如果该查询将访问包含在一个XML文档QString，使用QBuffer如下面的代码片段所示。假设myQString包含<document>content</document>
QBuffer device;
device.setData(myQString.toUtf8());
device.open(QIODevice.ReadOnly);
QXmlQuery query;
query.bindVariable("inputDocument", &device);
query.setQuery("doc($inputDocument)/query[theDocument]");
name必须不null。name。 ISNULL（ ）必须返回False 。如果name已绑定，其以前的绑定将被改写。该URI，它name计算结果为是任意的，可能会改变。
如果该变量绑定的变化（例如，飞行如果同名一个以前的绑定是一个QVariant，或者，如果没有先前的绑定） ，isValid（ ）将返回false，并且需要查询文本的重新编译。重新编译查询，请致电setQuery（ ） 。出于这个原因，bindVariable（ ）之前，应叫setQuery（） ，如果可能的话。
Note: device不能被删除，而这QXmlQuery存在。
结合查询的结果query，一个变量的名字name。
评价query当这个函数被调用时会被展开。
If query是无效的，行为是未定义的。query将被复制。
此功能被引入Qt的4.5 。
See also isValid（ ） 。
这是一个重载函数。
这个函数构造一个QXmlName从localName使用查询的namespace。然后，该函数的行为与重载函数。它等价于下面的代码片段。
QXmlNamePool namePool(query.namePool());
query.bindVariable(QXmlName(namePool, localName), value);
这是一个重载函数。
If localName是一个有效的NCName，这个功能相当于下面的代码片段。
QXmlNamePool namePool(query.namePool());
query.bindVariable(QXmlName(namePool, localName), device);
A QXmlName从构造localName，并传递到带有相应的过载device。
See also QXmlName.isNCName（ ） 。
这是一个重载函数。
具有相同的行为和效果被重载的函数，但需要在变量名localName作为QString。query用作重载的函数。
此功能被引入Qt的4.5 。
起动评价，并使其在可result。如果result为null，则行为是未定义的。评估发生增量（懒惰的评价） ，作为主叫方使用QXmlResultItems.next（）来获取下一个结果。
See also QXmlResultItems.next（ ） 。
评估该查询，并将其结果作为对一个序列的回调receiver callback。QXmlQuery不采取所有权callback。
如果评估过程中发生错误，错误信息被发送到messageHandler（）和false返回。
如果此查询is invalid，false返回和行为是未定义的。如果callback为空，行为是未定义的。
See also QAbstractXmlReceiver和isValid（ ） 。
尝试评估该查询，并将结果返回在target string list。
如果查询is valid和评估成功，则返回True 。否则，返回False，并且内容target是不确定的。
查询必须评估为序列xs:string值。如果查询不计算为一个字符串序列，这些值通常可以通过增加一个调用转换string()在本月底XQuery。
If target为null，则行为是未定义的。
评估查询，序列化输出为XML到output。
如果评估过程中发生错误，错误信息被发送到messageHandler（ ）的内容output是不确定的，false返回，否则true返回。
If output is null行为是不确定的。QXmlQuery不采取所有权output。
在内部，类QXmlFormatter用于此。
此功能被引入Qt的4.5 。
评估查询或样式表，并将输出写入到target。
QXmlSerializer用于将输出写入到target。在将来的版本中，它预计这一功能将被更改为尊重在样式表中设置序列化选项。
如果评估过程中发生错误，错误信息被发送到messageHandler（）和false返回。
If target is null或者是不是至少在开QIODevice.WriteOnly模式，其行为是未定义的。QXmlQuery不采取所有权target。
这是一个重载函数。
此功能被引入Qt的4.5 。
返回XSL -T样式表的模板，运行一个XSL -T样式表时，处理器将调用的名头。此功能仅在使用适用QXmlQuery处理XSL -T样式表。缺省情况下，初始模板设置。在这种情况下，一个默认的构造QXmlName返回。
此功能被引入Qt的4.5 。
See also setInitialTemplateName（ ） 。
返回True如果这个查询是有效的。无效的查询的例子是那些包含语法错误或者还没有setQuery（ ）召之即来呢。
返回处理这个编译和运行时消息的消息处理程序QXmlQuery。
See also setMessageHandler（ ） 。
返回此名称池QXmlQuery构建names。有没有setter的名字池，因为混合池的名称会导致错误，由于名称的混乱。
返回该网络管理器，或0 ，如果它没有被设置。
此功能被引入Qt的4.5 。
See also setNetworkAccessManager（ ） 。
返回一个值，指示这是什么QXmlQuery被用于。默认值是QXmlQuery.XQuery10，这意味着QXmlQuery被用于执行XQuery和XPath查询。QXmlQuery.XSLT20也可以退回，这表明QXmlQuery是运行XSL -T电子表格。
此功能被引入Qt的4.5 。
将焦点设置item。重点是一组上下文项表达式和路径表达式从导航的项目。例如，在表达式p/span时，该元件p计算结果为是重点下面的表达式，span。
焦点可以使用上下文项表达式来访问，即，点（ “。”） 。
默认情况下，焦点未设置，是不确定的。因此，它会导致动态误差，XPDY0002如果聚焦是试图将被访问。之前的查询设置与重点必须设置setQuery（ ） 。
没有设置它为null的项定义的行为。
这是一个重载函数。
将焦点是位于文档documentURI并返回True 。如果documentURI无法加载，则返回False。它是不确定在什么时候该文件可能被加载。当加载文档，消息处理程序和URI解析器在此设置QXmlQuery被使用。
If documentURI为空或不是一个有效的URI ，这个函数的行为是未定义的。
此功能被引入Qt的4.5 。
将焦点是document从读QIODevice并返回True 。如果document无法加载，则返回False。
QXmlQuery不采取所有权document。用户可以保证一个文件是可从document设备与该文件是不是空的。该设备必须至少在只读模式打开。document必须保持在范围只要当前查询是活动的。
这是一个重载函数。
此功能被引入Qt的4.5 。
这个函数的作用相同，调用setFocus（ ）过载与QIODevice其内容是focus编码为UTF- 8 。即，focus被视为它包含在XML文档。
返回作为过载相同的结果。
这是一个重载函数。
此功能被引入Qt的4.6 。
设置name初始模板。初始模板，而不是试图匹配模板的上下文节点（如果有的话）一个处理器调用第一个。如果初始模板没有设置，模板调用的标准顺序将被使用。
此功能仅在使用适用QXmlQuery处理XSL -T样式表。该名称将成为编译的样式表的一部分。因此，这个函数必须在调用之前调用setQuery（ ） 。
如果样式表没有命名模板name，该处理器将使用模板调用的标准顺序。
此功能被引入Qt的4.5 。
See also initialTemplateName（ ） 。
这是一个重载函数。
设置初始模板的名称，以localName，它必须是一个有效的local name。初始模板，而不是试图匹配模板的上下文节点（如果有的话）一个处理器调用第一个。如果初始模板没有设置，模板调用的标准顺序将被使用。
此功能仅在使用适用QXmlQuery处理XSL -T样式表。该名称将成为编译的样式表的一部分。因此，这个函数必须在调用之前调用setQuery（ ） 。
If localName不是一个有效的local name，效果是不确定的。如果样式表没有命名模板localName，该处理器将使用模板调用的标准顺序。
此功能被引入Qt的4.5 。
See also initialTemplateName（ ） 。
更改message handler这QXmlQuery至aMessageHandler。该查询将所有的编译和运行时消息，此消息处理程序。QXmlQuery不采取所有权aMessageHandler。
通常情况下，默认的消息处理就足够了。它写的编译和运行时消息，stderr。默认的消息处理程序，包括颜色代码，如果stderr可以使色彩。
请注意，更改消息处理程序查询已经编译后没有效果，即查询在运行时使用相同的消息处理程序，它使用在编译时。
When QXmlQuery电话QAbstractMessageHandler.message（ ） ，参数如下：
| message() argument | Semantics |
|---|---|
| QtMsgType type | Only QtWarningMsg and QtFatalMsg are used. The former identifies a compile or runtime warning, while the latter identifies a dynamic or static error. |
| const QString & description | An XHTML document which is the actual message. It is translated into the current language. |
| const QUrl &identifier | Identifies the error with a URI, where the fragment is the error code, and the rest of the URI is the error namespace. |
| const QSourceLocation & sourceLocation | Identifies where the error occurred. |
See also messageHandler（ ） 。
设置网络管理员newManager。QXmlQuery不采取所有权newManager。
此功能被引入Qt的4.5 。
See also networkAccessManager（ ） 。
此套QXmlQuery到XQuery从读sourceCode设备。该设备必须已经打开了至少QIODevice.ReadOnly。
documentURI表示从得到的查询sourceCode设备。它是静态上下文的基URI ，如在定义XQuery language。它在内部使用，以解决出现在查询中相对URI ，以及消息的报告。documentURI可以为空。如果为空，则application file path被使用。如果不是空的，它可以是相对的或绝对的。如果是相对的，它解决了自身对application file path之前就被采用。如果documentURI既不是一个有效的URI ，也没有空，其结果是不确定的。
如果查询包含一个静态错误（如语法错误） ，则错误消息被发送到messageHandler（）和isValid（ ）将返回false。
变量必须setQuery前绑定（ ）被调用。
的编码XQuery在sourceCode检测到内部使用的规则来设置和检测编码XQuery文件，这些文件中的解释XQuery language。
If sourceCode is null或无法读取，或者如果documentURI是不是一个有效的URI ，行为是未定义的。
See also isValid（ ） 。
此套QXmlQuery到XQuery从读queryURI。使用isValid（ ）调用此函数后。如果发生读取错误queryURI比如，查询不存在，无法读取，或者是无效的，isValid（ ）将返回false。
所支持的URI方案是相同的XQuery功能fn:doc，除了queryURI可以是一个变量绑定的对象。
baseURI是静态上下文的基URI ，如定义XQuery language。它在内部使用，以解决出现在查询中相对URI ，以及消息的报告。如果baseURI是空的，queryURI被使用。否则，baseURI被使用，并且它解决了对application file path如果它是相对的。
If queryURI为空或无效，或者如果baseURI是无效的，这个函数的行为是未定义的。
这是一个重载函数。
这个函数的行为和要求是一样的setQuery （QIODevice* ，常量QUrl＆），后XQuery已经读取的IO设备插入一个字符串。因为sourceCode已经是一个Unicode字符串，检测它的编码是不必要的。
设置的URI解析器resolver。QXmlQuery不采取所有权resolver。
See also uriResolver（ ） 。
返回查询的URI解析器。如果没有的URI解析器已定，QtXmlPatterns将使用的URI的查询，因为它们。
这个URI解析器提供了一个抽象层，或polymorphic URIs。解析器可以重写logicalURI与物理的，或者它可以翻译过时的或无效的URI来有效的。
QtXmlPatterns调用的URI解析器遇到所有的URI ，除了命名空间。具体而言，所有内建的函数来处理的URI （fn:doc()和fn:doc-available()） 。
在的情况下fn:doc()，绝对URI是基URI在静态情况下（这最有可能是查询的位置） 。而不是使用URI指定的用户的返回值QAbstractUriResolver.resolve（）将被使用。
When QtXmlPatterns电话QAbstractUriResolver.resolve（ ）的绝对URI是由授权的URIXQuery语言，相对URI是由用户指定的URI。
See also setUriResolver（ ） 。
| PyQt 4.10.3 for X11 | Copyright © Riverbank Computing Ltd and Nokia 2012 | Qt 4.8.5 |