ios中XMPPFramework 简介

本文链接:http://www.cocoachina.com/ios/20141219/10703.html

XMPPFramework是一个OS X/iOS平台的开源项目,使用Objective-C实现了XMPP协议(RFC-3920),同时还提供了用于读写XML的工具,大大简化了基于XMPP的通信应用的开发

1. 登录和好友上下线

1.1XMPP中常用对象们

XMPPStream:xmpp基础服务类

XMPPRoster:好友列表类

XMPPRosterCoreDataStorage:好友列表(用户账号)在core data中的操作类

XMPPvCardCoreDataStorage:好友名片(昵称,签名,性别,年龄等信息)在core data中的操作类

XMPPvCardTemp:好友名片实体类,从数据库里取出来的都是它

xmppvCardAvatarModule:好友头像

XMPPReconnect:如果失去连接,自动重连

XMPPRoom:提供多用户聊天支持

XMPPPubSub:发布订阅

1.2登录操作,也就是连接xmpp服务器


- (void)connect {

if (self.xmppStream == nil) {

self.xmppStream = [[XMPPStream alloc] init];

[self.xmppStream addDelegate:self delegateQueue:dispatch_get_main_queue()];

}

if (![self.xmppStream isConnected]) {

NSString *username = [[NSUserDefaults standardUserDefaults] objectForKey:@"username"];

XMPPJID *jid = [XMPPJID jidWithUser:username domain:@"lizhen" resource:@"Ework"];

[self.xmppStream setMyJID:jid];

[self.xmppStream setHostName:@"10.4.125.113"];

NSError *error = nil;

if (![self.xmppStream connect:&error]) {

NSLog(@"Connect Error: %@", [[error userInfo] description]);

}

}

}


connect成功之后会依次调用XMPPStreamDelegate的方法,首先调用

- (void)xmppStream:(XMPPStream *)sender socketDidConnect:(GCDAsyncSocket *)socket

- (void)xmppStreamDidConnect:(XMPPStream *)sender

在该方法下面需要使用xmppStream 的authenticateWithPassword方法进行密码验证,成功的话会响应delegate的方法,就是下面这个

- (void)xmppStreamDidAuthenticate:(XMPPStream *)sender


1.3上线

实现 - (void)xmppStreamDidAuthenticate:(XMPPStream *)sender 委托方法

- (void)xmppStreamDidAuthenticate:(XMPPStream *)sender {

XMPPPresence *presence = [XMPPPresence presenceWithType:@"available"];

[self.xmppStream sendElement:presence];

}

1.4退出并断开连接

- (void)disconnect {

XMPPPresence *presence = [XMPPPresence presenceWithType:@"unavailable"];

[self.xmppStream sendElement:presence];

[self.xmppStream disconnect];

}

1.5好友状态

获取好友状态,通过实现

- (void)xmppStream:(XMPPStream *)sender didReceivePresence:(XMPPPresence *)presence

...

presence 的状态:

available 上线

away 离开

do not disturb 忙碌

unavailable 下线

2. 接收消息和发送消息

2.1接收消息

通过实现

- (void)xmppStream:(XMPPStream *)sender didReceiveMessage:(XMPPMessage *)message;

方法

当接收到 message 标签的内容时,XMPPFramework 框架回调该方法

根据 XMPP 协议,消息体的内容存储在标签 body 内

- (void)xmppStream:(XMPPStream *)sender didReceiveMessage:(XMPPMessage *)message {

NSString *messageBody = [[message elementForName:@"body"] stringValue];

}

2.2发送消息

发送消息,我们需要根据 XMPP 协议,将数据放到标签内,


- (void)sendMessage:(NSString *) message toUser:(NSString *) user {

NSXMLElement *body = [NSXMLElement elementWithName:@"body"];

[body setStringValue:message];

NSXMLElement *message = [NSXMLElement elementWithName:@"message"];

[message addAttributeWithName:@"type" stringValue:@"chat"];

NSString *to = [NSString stringWithFormat:@"%@@example.com", user];

[message addAttributeWithName:@"to" stringValue:to];

[message addChild:body];

[self.xmppStream sendElement:message];

}

3. 获取好友信息和删除好友

3.1好友列表和好友名片

[_xmppRoster fetchRoster];//获取好友列表

//获取到一个好友节点

- (void)xmppRoster:(XMPPRoster *)sender didRecieveRosterItem:(NSXMLElement *)item

//获取完好友列表

- (void)xmppRosterDidEndPopulating:(XMPPRoster *)sender

//到服务器上请求联系人名片信息

- (void)fetchvCardTempForJID:(XMPPJID *)jid;

//请求联系人的名片,如果数据库有就不请求,没有就发送名片请求

- (void)fetchvCardTempForJID:(XMPPJID *)jid ignoreStorage:(BOOL)ignoreStorage;

//获取联系人的名片,如果数据库有就返回,没有返回空,并到服务器上抓取

- (XMPPvCardTemp *)vCardTempForJID:(XMPPJID *)jid shouldFetch:(BOOL)shouldFetch;

//更新自己的名片信息

- (void)updateMyvCardTemp:(XMPPvCardTemp *)vCardTemp;

//获取到一盒联系人的名片信息的回调

- (void)xmppvCardTempModule:(XMPPvCardTempModule *)vCardTempModule

didReceivevCardTemp:(XMPPvCardTemp *)vCardTemp

forJID:(XMPPJID *)jid

你可能感兴趣的:(ios中XMPPFramework 简介)