1IQ 节

<iq>节表示的是Info/Query(信息与查询)，它为XMPP通信提供请求与响应机制。它与HTTP协议的基本工作原理非常相似，允许获取和设置查询，与HTTP 的GET 和POST 动作类似。每个节都必须有一个响应，而且前面曾经提到过，该节的必需的id 属性将用来把响应与导致该响应的请求关联起来。节有四种，通过该节的type 属性区分。有两种节请求(get 和set)和两种响应(result 和error)。在本书中，这些节通常被缩写为IQ-get、IQ-set、IQ-result和IQ-error。每一个IQ-get 或IQ-set 节均必须接收响应的IQ-result 或IQ-error 节。

下面的示例给出了一些常见的节以及它们可能的响应。注意，与和节(它们定义了子元素)不同，节通常只包含与它们功能相关的扩展元素。此外，每一对节必须匹配id 属性。

<iq from = 'jane@longbourn.lit/garden'

type = 'get'

id = 'roster1'>

<query xmlns='jabber:iq:roster'/>

</iq>

<id to = 'jane@longbourn.lit/garden'

type = 'error'

id = 'roster1'>

<query xmlns='jabber:iq:roster'/>

<error type='cancel'>

<feature-not-implementer xmlns='urn:left:params:xml:ns:xmpp-stanzas'/>

</error>

</iq>

Jane 向她的服务器发送了一个格式错误的花名册请求。服务器使用一个错误提示节作为响应。后面我们将详细讨论错误提示节。

<iq from = 'jane@longbourn.lit/garden'

type = 'get'

id='roster2'>

<query xmlns='jabber:iq:roster'/>

</iq>

<iq to='jane@longbourn.lit/garden'

type='result'

id='roster2'>

<query xmlns='jabber:iq:roster'>

<item jid='elizabeth@longbourn.lit' name = 'Elizabeth'/>

<item jid='bingley@netherfield.lit' name = 'Bingley'/>

</query>

</iq>

在重新发送正确的请求之后，服务器将Jane 的简短花名册响应给她。可以看到Elizabeth 和Bingley 均在Jane 的联系人列表中。

第1 章了解 XMPP 协议

<id from = 'jane@longbourn.lit/garden'

type = 'set'

id = 'roster3'>

<query xmlns = 'jabber:iq:roster'>

<item jid='darcy@pemberley.lit' name = 'Mr.Dancy'/>

</query>

</iq>

<iq to = 'jane@longbourn.lit/garden'

type = 'result'

id = 'roster3'/>

Jane 试图将Darcy 添加到自己的花名册中，服务器用一个空白IQ-result 节来指出添加成功。如果应答节只是成功确认，那么IQ-result 节通常是空白的。

在任何需要结果数据或者需要简单确认的场合中，<iq>节都非常有用。大多数XMPP 扩展协议混合使用<iq>和<message>节来实现它们的功能。<iq>节用于类似于配置和状态变化这样的信息，而<message>节则用于常规通信。在某些场合中，<iq>节也用于通信，这是因为节确认机

制可实现限速功能。