【iOS XMPP】使用XMPPFramewok（五）：好友列表

好友列表

 

好友列表，在 XMPP 中被称为 roster，花名册？

获取 roster 需要客户端发送 <iq /> 标签向 XMPP 服务器端查询

 

一个 IQ 请求：

<iq type="get"

　　from="[email protected]"

　　to="example.com"

　　id="1234567">

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

<iq />

type 属性，说明了该 iq 的类型为 get，与 HTTP 类似，向服务器端请求信息

from 属性，消息来源，这里是你的 JID

to 属性，消息目标，这里是服务器域名

id 属性，标记该请求 ID，当服务器处理完毕请求 get 类型的 iq 后，响应的 result 类型 iq 的 ID 与 请求 iq 的 ID 相同

<query xmlns="jabber:iq:roster"/> 子标签，说明了客户端需要查询 roster

 

- (void)queryRoster {
    NSXMLElement *query = [NSXMLElement elementWithName:@"query" xmlns:@"jabber:iq:roster"];
    NSXMLElement *iq = [NSXMLElement elementWithName:@"iq"];
    XMPPJID *myJID = self.xmppStream.myJID;
    [iq addAttributeWithName:@"from" stringValue:myJID.description];
    [iq addAttributeWithName:@"to" stringValue:myJID.domain];
    [iq addAttributeWithName:@"id" stringValue:[self generateID]];
    [iq addAttributeWithName:@"type" stringValue:@"get"];
    [iq addChild:query];
    [self.xmppStream sendElement:iq];
}

 

一个 IQ 响应：

<iq type="result"

　　id="1234567"

　　to="[email protected]">

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

　　　　<item jid="[email protected]" name="小燕" />

　　　　<item jid="[email protected]" name="小强"/>

　　<query />

<iq />

type 属性，说明了该 iq 的类型为 result，查询的结果

<query xmlns="jabber:iq:roster"/> 标签的子标签 <item />，为查询的子项，即为 roster

item 标签的属性，包含好友的 JID，和其它可选的属性，例如昵称等。

 

通过实现

- (BOOL)xmppStream:(XMPPStream *)sender didReceiveIQ:(XMPPIQ *)iq;

方法

当接收到 <iq /> 标签的内容时，XMPPFramework 框架回调该方法

- (BOOL)xmppStream:(XMPPStream *)sender didReceiveIQ:(XMPPIQ *)iq {
    if ([@"result" isEqualToString:iq.type]) {
        NSXMLElement *query = iq.childElement;
        if ([@"query" isEqualToString:query.name]) {
            NSArray *items = [query children];
            for (NSXMLElement *item in items) {
                NSString *jid = [item attributeStringValueForName:@"jid"];
                XMPPJID *xmppJID = [XMPPJID jidWithString:jid];
                [self.roster addObject:xmppJID];
            }
        }
    }
}