首页 > 代码库 > 【iOS XMPP】使用XMPPFramewok之好友列表

【iOS XMPP】使用XMPPFramewok之好友列表

 

 

好友列表

 

好友列表,在 XMPP 中被称为 roster,花名册?

 

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

 

一个 IQ 请求:

 

<iq type="get"

 

  from="xiaoming@example.com"

 

  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="xiaoming@example.com">

 

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

 

    <item jid="xiaoyan@example.com" name="小燕" />

 

    <item jid="xiaoqiang@example.com" 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];

            }

        }

    }

}