可以号称史上最详细的xmpp做iOS客户端聊天介绍。
简介:XMPP协议是一种基于Socket长连接、以XML格式进行基本信息交换、C/S S/S多种架构的聊天协议
XMPPServer 基于XMPP协议的服务端(例如eJabber、OpenFire)
openfire服务器安装和配置连接地址: http://www.cnblogs.com/hoojo/archive/2012/05/17/2506769.html
一.框架导入
1.在header search Path 中 添加 /user/include/libxml2
2.添加libxml2.dylib与libresolv.dylib
3.拷贝源码目录下的 Authentication Categories Core 和 Utilities 到项目根目录下并添加到项目中
二.核心库
1.XMPPStream 核心中的核心:xml流
2.XMPPElement xml基本元素/stanza
3.XMPPIQ 查询节点 Info/Query的缩写 类似于HTTP请求
4.XMPPJID 用户的标识/身份证
5.XMPPMessage 基本消息节点(XML)
6. XMPPPresence 出席节点(XML
7.XMPPParser XML解析,Core中唯一一个不太重要的类
8.XMPPModule 各种功能模块的基类,继承它的模块均需在xmppStream中激活,基于多播代理,可添加多个委托实例
三.扩展库
1.XMPPRoster好友列表
2.XMPPReconnect 重连
3.ProcessOne 推送通知与快速重连
4.XMPPBandwidthMonitor 带宽监视
5.XMPPFileTransfer 文件传输
6.XMPPRoom(XEP-0045) 聊天室
7.XMPPvCard(XEP--0054) 个人资料/名片
8.XMPPResultSet(XEP-0059) XML中的结果集
9.XMPPPubSub(XEP-0060) 发布/订阅模块
10.XMPPRegistration(XEP-0077) 注册与密码修改
11.XMPPMessage+XEP_0085 消息节点的聊天状态扩展
12.XMPPMessageArchiving(XEP-0136) 聊天记录同步
13.XMPPMessageDeliveryReceipts(XEP-0184) 接受消息回执
14.XMPPBlocking(XEP-0191) 黑名单/屏蔽用户
15.XMPPStreamManagement(XEP-0198) XML流恢复(区别于Reconnect)
16.XMPPAutoPing(XEP-0199) 心跳检测
17.XMPPAutoTime(XEP-0202) 时间比对
18.NSXMLElement+XEP_0203 (DelayedMessage)延迟消息
19.XMPPAttentionModule(XEP-0224) 引起对方注意的消息模块,需激活
20.XMPPMessageCarbons(XEP-0280) 同一个用户多设备登陆(jid的资源部分不同)时的消息多发
21.NSXMLElement+XEP_0297 XML节点扩展--消息转发
22.XMPPMessage+XEP_0308 一种特殊消息:对已经发送的某条消息进行更改/订正
23.XMPPMessage+XEP_0333 更佳先进的消息回执 Message的分类
24.XMPPElement+JSON(XEP-0335) 在XML节点中插入JSON
四.xmpp建立连接并登录
1.新建一个 XMPPStream 对象,添加委托
添加委托方法 - (void)addDelegate:(id)delegate delegateQueue:(dispatch_queue_t)delegateQueue
参数 delegateQueue 为委托回调所使用的 GCD 队列,dispatch_get_main_queue() 获取主线程 GCD 队列
2.xmppjid
JID 一般由三部分构成:用户名,域名和资源名,例如 test@example.com/Anthony 如果没有设置主机名,则使用 JID 的域名作为主机名 端口号是可选的,默认是 5222
3.身份认证
实现 - (void)xmppStreamDidConnect:(XMPPStream *)sender 委托方法
连接服务器成功后,回调该方法
身份认证方法 - (BOOL)authenticateWithPassword:(NSString *)inPassword error:(NSError **)errPtr
4.上线
实现 - (void)xmppStreamDidAuthenticate:(XMPPStream *)sender 委托方法 身份认证成功后,回调该方法 新建一个 XMPPPresence 对象,类型为 available,发送!
5.退出并断开连接
新建一个 XMPPPresence 对象,类型为 unavailable,发送!
断开连接
五.xmpp注册
1.判断xmpp否连接,是否带注册支持
[[self appDelegate] xmppStream] isConnected] && [[[self appDelegate]xmppStream] supportsInBandRegistration]
2.开始注册
设置myjid和密码 1.setMyJID 2.registerWithPassword
六.好友列表
1. 获取好友列表
注意本地数据库缓存 NSManagedObjectContext *context = [[[self appDelegate] xmppRosterStorage] mainThreadManagedObjectContext];
NSEntityDescription *entity = [NSEntityDescription entityForName:@"XMPPUserCoreDataStorageObject" inManagedObjectContext:context]; NSFetchRequest *request = [[NSFetchRequest alloc]init];
[request setEntity:entity];
NSError *error ;
NSArray *friends = [context executeFetchRequest:request error:&error];
2.对方添加好友时 更新列表 // 已经互为好友以后,会回调此
- (void)xmppRoster:(XMPPRoster *)sender didReceiveRosterItem:(NSXMLElement *)item {
NSString *subscription = [item attributeStringValueForName:@"subscription"];
if ([subscription isEqualToString:@"both"]) {
NSLog(@"双方已经互为好友");
if (self.buddyListBlock) {
// 更新好友列表
}
}
}
七.xmpp添加好友
[[[self appDelegate] xmppRoster] addUser:[XMPPJID jidWithString:@"admin@127.0.0.1"] withNickname:@"admin"];
八.xmpp发送消息和接收消息
1.发送消息
我们需要根据 XMPP 协议,将数据放到 <message /> 标签内,例如:
<message type="chat" to="xiaoming@example.com">
<body>Hello World!<body />
<message />
- (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];
}
2.接收消息
当接收到 <message /> 标签的内容时,XMPPFramework 框架回调该方法
根据 XMPP 协议,消息体的内容存储在标签 <body /> 内
- (void)xmppStream:(XMPPStream *)sender didReceiveMessage:(XMPPMessage *)message {
NSString *messageBody = [[message elementForName:@"body"] stringValue];
}