# QAbstractXmlReceiver Class Reference ## [[QtXmlPatterns](index.htm) module] 該QAbstractXmlReceiver類提供了一個回調接口，用于將一個輸出[QXmlQuery](qxmlquery.html)。[More...](#details) 通過繼承[QXmlSerializer](qxmlserializer.html)。 ### Methods * `__init__ (self)` * `atomicValue (self, QVariant?value)` * `attribute (self, QXmlName?name, QStringRef?value)` * `characters (self, QStringRef?value)` * `comment (self, QString?value)` * `endDocument (self)` * `endElement (self)` * `endOfSequence (self)` * `namespaceBinding (self, QXmlName?name)` * `processingInstruction (self, QXmlName?target, QString?value)` * `startDocument (self)` * `startElement (self, QXmlName?name)` * `startOfSequence (self)` * * * ## Detailed Description 該QAbstractXmlReceiver類提供了一個回調接口，用于將一個輸出[QXmlQuery](qxmlquery.html)。 QAbstractXmlReceiver是提供一個回調接口的抽象基類，用于接收[XQuery sequence](#xquery-sequence)，一個通常的輸出[QXmlQuery](qxmlquery.html)和轉化的順序為您選擇，通常是XML的結構。考慮例子： ``` [QXmlQuery](qxmlquery.html) query; query.setQuery("doc('index.html')/html/body/p[1]"); [QXmlSerializer](qxmlserializer.html) serializer(query, myOutputDevice); query.evaluateTo(&serializer); ``` 首先它構造一個[query](qxmlquery.html)這會從文檔的第一段`index.html`。然后，它構造了一個[XML serializer](qxmlserializer.html)與[query](qxmlquery.html)和[myOutputDevice](qiodevice.html)（請注意[serializer](qxmlserializer.html)是_XML receiver_，即QAbstractXmlReceiver的一個子類） 。最后，它[evaluates](qxmlquery.html#evaluateTo)該[query](qxmlquery.html)，生產調用的有序序列[serializer's](qxmlserializer.html)回調函數。回調的序列轉換查詢輸出到XML ，并將其寫入到[myOutputDevice](qiodevice.html)。 雖然該示例使用[QXmlQuery](qxmlquery.html)產生回調到QAbstractXmlReceiver功能的序列，可以直接，只要你的電話的序列代表一個有效的調用回調函數[XQuery sequence](#xquery-sequence)。 ### XQuery Sequences 一個[XQuery](index.htm) _sequence_是零的有序集合，一個或多個_items_。每_item_或者是一個_atomic value_或_node_。一個_atomic value_是一個簡單的數據值。 有6種_nodes_。 * An _Element Node_ represents an XML element. * An _Attribute Node_ represents an XML attribute. * A _Document Node_ represents an entire XML document. * A _Text Node_ represents character data (element content). * A _Processing Instruction Node_ represents an XML processing instruction, which is used in an XML document to tell the application reading the document to perform some action. A typical example is to use a processing instruction to tell the application to use a particular XSLT stylesheet to display the document. * And a _Comment node_ represents an XML comment. 該_sequence_的_nodes_和_atomic values_遵循以下規則。需要注意的是_Namespace Node_指的是一種特殊的_Attribute Node_與名_xmlns_。 * Each _node_ appears in the _sequence_ before its children and their descendants appear. * A _node_'s descendants appear in the _sequence_ before any of its siblings appear. * A _Document Node_ represents an entire document. Zero or more _Document Nodes_ can appear in a _sequence_, but they can only be top level items (i.e., a _Document Node_ can't be a child of another _node_. * _Namespace Nodes_ immediately follow the _Element Node_ with which they are associated. * _Attribute Nodes_ immediately follow the _Namespace Nodes_ of the element with which they are associated, or... * If there are no _Namespace Nodes_ following an element, then the _Attribute Nodes_ immediately follow the element. * An _atomic value_ can only appear as a top level _item_, i.e., it can't appear as a child of a _node_. * _Processing Instruction Nodes_ do not have children, and their parent is either a _Document Node_ or an _Element Node_. * _Comment Nodes_ do not have children, and their parent is either a _Document Node_ or an _Element Node_. 該_sequence_的_nodes_和_atomic values_被發送到一個QAbstractXmlReceiver （[QXmlSerializer](qxmlserializer.html)在上面的例子）作為呼叫接收器的回調函數的序列。的回調函數序列的項目的映射如下。 * [startDocument](qabstractxmlreceiver.html#startDocument)() and [endDocument](qabstractxmlreceiver.html#endDocument)() are called for each _Document Node_ in the _sequence_. [endDocument](qabstractxmlreceiver.html#endDocument)() is not called until all the _Document Node's_ children have appeared in the _sequence_. * [startElement](qabstractxmlreceiver.html#startElement)() and [endElement](qabstractxmlreceiver.html#endElement)() are called for each _Element Node_. [endElement](qabstractxmlreceiver.html#endElement)() is not called until all the _Element Node's_ children have appeared in the _sequence_. * [attribute](qabstractxmlreceiver.html#attributex)() is called for each _Attribute Node_. * [comment](qabstractxmlreceiver.html#comment)() is called for each _Comment Node_. * [characters](qabstractxmlreceiver.html#characters)() is called for each _Text Node_. * [processingInstruction](qabstractxmlreceiver.html#processingInstruction)() is called for each _Processing Instruction Node_. * [namespaceBinding](qabstractxmlreceiver.html#namespaceBinding)() is called for each _Namespace Node_. * [atomicValue](qabstractxmlreceiver.html#atomicValue)() is called for each _atomic value_. 對于一個完整的解釋[XQuery](index.htm)序列，請訪問[XQuery Data Model](http://www.w3.org/TR/xpath-datamodel/)。 * * * ## Method Documentation ``` QAbstractXmlReceiver.__init__ (self) ``` 構造一個抽象的XML接收器。 ``` QAbstractXmlReceiver.atomicValue (self, QVariant?value) ``` 這種方法是抽象的，應在任何子類中重新實現。 當一個原子值出現在這個回調函數被調用[sequence](qabstractxmlreceiver.html#xquery-sequence)。該_value_是一個簡單的[data value](qvariant.html)。它是保證[valid](qvariant.html#isValid)。 ``` QAbstractXmlReceiver.attribute (self, QXmlName?name, QStringRef?value) ``` 這種方法是抽象的，應在任何子類中重新實現。 ``` QAbstractXmlReceiver.characters (self, QStringRef?value) ``` 這種方法是抽象的，應在任何子類中重新實現。 當一個文本節點會出現在這個回調函數被調用[sequence](qabstractxmlreceiver.html#xquery-sequence)。該_value_包含的文本。相鄰的文本節點可能不會出現在[sequence](qabstractxmlreceiver.html#xquery-sequence)，也就是說，這個回調不能說是連續兩次。 ``` QAbstractXmlReceiver.comment (self, QString?value) ``` 這種方法是抽象的，應在任何子類中重新實現。 當一個注釋節點會出現在這個回調函數被調用[sequence](qabstractxmlreceiver.html#xquery-sequence)。該_value_是注釋文本，其中不得包含字符串“ - ” 。 ``` QAbstractXmlReceiver.endDocument (self) ``` 這種方法是抽象的，應在任何子類中重新實現。 當一個文檔節點的末尾會出現在這個回調函數被調用[sequence](qabstractxmlreceiver.html#xquery-sequence)。 ``` QAbstractXmlReceiver.endElement (self) ``` 這種方法是抽象的，應在任何子類中重新實現。 當一個元素節點的結尾會出現在這個回調函數被調用[sequence](qabstractxmlreceiver.html#xquery-sequence)。 ``` QAbstractXmlReceiver.endOfSequence (self) ``` 這種方法是抽象的，應在任何子類中重新實現。 此回調被調用一次只，右后[sequence](qabstractxmlreceiver.html#xquery-sequence)結束。 ``` QAbstractXmlReceiver.namespaceBinding (self, QXmlName?name) ``` 這種方法是抽象的，應在任何子類中重新實現。 此回調被調用時，一個命名空間綁定在元素的范圍。命名空間是由一個URI來定義。在[QXmlName](qxmlname.html) _name_，的值[QXmlName.namespaceUri](qxmlname.html#namespaceUri)（）是URI。價值[QXmlName.prefix](qxmlname.html#prefix)（）是該URI被綁定到前綴。本地名稱是微不足道的，可以是任意值。 ``` QAbstractXmlReceiver.processingInstruction (self, QXmlName?target, QString?value) ``` 這種方法是抽象的，應在任何子類中重新實現。 當一個處理指令出現在此回調被調用[sequence](qabstractxmlreceiver.html#xquery-sequence)。處理指令用于在XML文檔中告訴應用程序讀取文件執行某些操作。一個典型的例子是使用處理指令來告訴應用程序使用特定的XSLT樣式表來處理文檔。 ``` <?xml-stylesheet type="test/xsl" href="formatter.xsl"?> ``` _target_是[name](qxmlname.html)的處理指令。其_prefix_和_namespace URI_必須都是空的。其_local name_是目標。在上面的例子中，域名是_xml-stylesheet_。 該_value_指定要采取的行動。注意，這個_value_不得包含字符串“ \u003e ” 。在上面的例子中，_value_ is _type="test/xsl" href="formatter.xsl_。 一般情況下，應避免使用處理指令，因為他們沒有意識到命名空間和在許多情況下被剝離出來呢。處理指令通常可以替換為一個自定義的命名空間的元素。 ``` QAbstractXmlReceiver.startDocument (self) ``` 這種方法是抽象的，應在任何子類中重新實現。 當一個文檔節點出現在這個回調函數被調用[sequence](qabstractxmlreceiver.html#xquery-sequence)。 ``` QAbstractXmlReceiver.startElement (self, QXmlName?name) ``` 這種方法是抽象的，應在任何子類中重新實現。 當一個新的元素節點出現在這個回調函數被調用[sequence](qabstractxmlreceiver.html#xquery-sequence)。_name_是有效[name](qxmlname.html)該節點的元素。 ``` QAbstractXmlReceiver.startOfSequence (self) ``` 這種方法是抽象的，應在任何子類中重新實現。 此回調被調用一次而已，正確的前[sequence](qabstractxmlreceiver.html#xquery-sequence)開始。