iOS—XMPP登录、聊天

通常的做法是我们会新建一个专门针对 xmpp 库的管理类,来处理所有的关于 xmpp 类的调用,这也是对封装的一点运用,不会对其他业务代码有侵入性,并且也方便处理整个关于 xmpp 的逻辑处理,这样的管理类一般会采用单例模式。

说到 xmpp ,最重要的一个类非 XMPPStream 莫属,所有的「连接」、「登录」、「注册」、「授权」、「失去连接」等操作的回调都通过它,所以必须需要有这么一个实例。另外,还添加了一个心跳处理的类来定时发送 ping 包。

@interface XMPPManager ()

@property (nonatomic, strong) XMPPStream *xmppStream;
/** 定时发送心跳包 */
@property (nonatomic, strong) XMPPAutoPing *xmppAutoPing;

@end

// 单例方法,略...
// 重新init方法,在里面调用setupStream方法,略...

 /** Setup the XMPP stream */
- (void)setupStream {
    _xmppStream = [[XMPPStream alloc] init];
    // 在多线程中运行,为了不阻塞UI线程,
    [_xmppStream addDelegate:self delegateQueue:dispatch_get_global_queue(0, 0)];
        
    _xmppAutoPing = [[XMPPAutoPing alloc] init];
    _xmppAutoPing.pingInterval = 20.f; // 心跳包间隔
    [_xmppAutoPing activate:_xmppStream];
    [_xmppAutoPing addDelegate:self delegateQueue:dispatch_get_global_queue(0, 0)];
}

这里需要提前申明一下,在我现在所开发的 App 里,当用户注册了账号之后,我们的后台会自动在 openfire 服务器中为这个用户做一遍注册操作,这样在 App 端就不需要使用 xmpp 注册了。

以下是连接方法:

/** 开始连接,这里还只是socket连接 */
- (void)startConnect {
    NSString *uid = @"1024"; // 我们的就是用户的uid
    // jid的固定格式:「uid」@「IP或域名」/ 「Resource」
    // 比如:1024@192.168.1.1/iOS_V1.0
    NSString *jidStr = [NSString stringWithFormat:@"%@@%@/%@", uid, @"192.168.1.1", @"iOS_V1.0"];
    XMPPJID *xmppJID  = [XMPPJID jidWithString:jidStr];
    [self.xmppStream setMyJID:xmppJID];
    
    NSError *error;
    [self.xmppStream connectWithTimeout:XMPPStreamTimeoutNone error:&error];
}

接下来,监听回调方法:(并加了一些注释,解释当前的步骤 xmpp 都做了些什么操作)

#pragma mark - XMPPStreamDelegate

- (void)xmppStreamWillConnect:(XMPPStream *)sender {
    NSLog(@"socket正在连接...");
}

- (void)xmppStream:(XMPPStream *)sender socketDidConnect:(GCDAsyncSocket *)socket {
    NSLog(@"socket连接成功...");
    // 连接成功之后,由客户端xmpp发送一个stream包给服务器,服务器监听来自客户端的stream包,并返回stream feature包
}

- (void)xmppStreamDidConnect:(XMPPStream *)sender {
    NSLog(@"xmpp连接成功,正在授权......");
    NSError *error;
    [self.xmppStream authenticateWithPassword:@"apple520" error:&error];
    // 客户端xmpp发送auth包,请求授权;服务器返回success;发送xmpp-bind包、xmpp-session包等。
}

- (void)xmppStream:(XMPPStream *)sender didNotAuthenticate:(NSXMLElement *)error {
    NSLog(@"️xmpp授权失败:%@", error.description);
}

- (void)xmppStreamDidAuthenticate:(XMPPStream *)sender {
    NSLog(@"xmpp授权成功。");
    // 只有进入到这里,才算是真正的可以聊天了
}

- (void)xmppStreamDidDisconnect:(XMPPStream *)sender withError:(NSError *)error {
    NSLog(@"️xmpp失去连接。");
}

整个 xmpp 连接过程相对来说比较简单,完成上面的步骤算是最初级的。然而在实际的应用中,会遇到各种各样的连接问题,以至于用户无法正常聊天。当 xmpp 连接上了之后,并不会一直处于连接状态,可能因为网络问题断开连接,因为在另一个设备登录被迫下线,或者服务器出错导致失去连接。这些问题都需要客户端和服务器端来联调解决,客户端要考虑各种情况,来保证用户可以顺利的收发消息。

以下是 xmpp 连接中收发的数据包事例:

17:22:41.357  -[XMPPManager xmppStreamWillConnect:] socket正在连接...

17:22:42.100  -[XMPPManager xmppStream:socketDidConnect:] socket连接成功...

17:22:42.102  SEND: <?xml version='1.0'?>

17:22:42.103  SEND: <stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams' version='1.0' to='192.168.1.1'>

17:22:43.085  RECV: <stream:features xmlns:stream="http://etherx.jabber.org/streams"><mechanisms xmlns="urn:ietf:params:xml:ns:xmpp-sasl"><mechanism>PLAIN</mechanism></mechanisms><auth xmlns="http://jabber.org/features/iq-auth"/></stream:features>

17:22:43.086  -[XMPPManager xmppStreamDidConnect:] [Line 198] xmpp连接成功, 正在授权......

17:22:43.087  SEND: <auth xmlns="urn:ietf:params:xml:ns:xmpp-sasl" mechanism="PLAIN">DJhJ5hsADHd824</auth>
<auth xmlns="urn:ietf:params:xml:ns:xmpp-sasl" mechanism="PLAIN">DJhJ5hsADHd824</auth><resource>iOS_V1.0</resource>

17:22:43.534  RECV: <success xmlns="urn:ietf:params:xml:ns:xmpp-sasl"/>

17:22:43.534  SEND: <stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams' version='1.0' to='192.168.1.1'>

17:22:43.870  RECV: <stream:features xmlns:stream="http://etherx.jabber.org/streams"><bind xmlns="urn:ietf:params:xml:ns:xmpp-bind"/><session xmlns="urn:ietf:params:xml:ns:xmpp-session"/></stream:features>

17:22:43.871  SEND: <iq type="set" id="123BF55A-C6FC-4AA8-A922-E1B869D6D731"><bind xmlns="urn:ietf:params:xml:ns:xmpp-bind"><resource>iOS_V1.0</resource></bind></iq>

17:22:44.261  RECV: <iq xmlns="jabber:client" type="result" id="123BF55A-C6FC-4AA8-A922-E1B869D6D731" to="192.168.1.1/isaw95526287f"><bind xmlns="urn:ietf:params:xml:ns:xmpp-bind"><jid>1024@192.168.1.1/iOS_V1.0</jid></bind></iq>

17:22:44.262  SEND: <iq type="set" id="80BA9B44-1247-4219-9F54-0C1E63F424A0"><session xmlns="urn:ietf:params:xml:ns:xmpp-session"/></iq>

17:22:44.669  RECV: <iq xmlns="jabber:client" type="result" id="80BA9B44-1247-4219-9F54-0C1E63F424A0" to="1024@192.168.1.1/iOS_V1.0"/>

17:22:44.670  -[XMPPManager xmppStreamDidAuthenticate:] [Line 208] xmpp授权成功。

最后来说说聊天,也就是发消息。消息有很多类型,比如文本、图片、音频、图文等等,所以在消息体中需要有字段来判别此消息的类型。我所开发的 App 中,消息类型有将近 20 种,扩展了很多字段,甚至还插入了 JSON 字符串在里面。

以下是一个简单的单聊发消息事例:(在我的 App 中,我写了一个专门用来处理消息的类,解析消息,存消息,并转发给相应的类)

//生成XML消息文档
NSXMLElement *messageElement = [NSXMLElement elementWithName:@"message"];

// 聊天类型,区别群聊(groupchat)和单聊(chat)
[messageElement addAttributeWithName:@"type" stringValue:@"chat"];

// 发送给谁
[messageElement addAttributeWithName:@"to" stringValue:@"2048@192.168.1.1/iOS_V1.0"];

// 由谁发送
[messageElement addAttributeWithName:@"from" stringValue:@"1024@192.168.1.1/iOS_V1.0"];

// 添加消息ID
[messageElement addAttributeWithName:@"id" stringValue:[self.xmppStream generateUUID]];

// 消息内容
NSXMLElement *body = [NSXMLElement elementWithName:@"body"];
[body setStringValue:@"今天的天气真好。"];
[messageElement addChild:body];

// 消息类型,1代表普通文本,2代表图片,3代表音频
NSXMLElement *itemType =[NSXMLElement elementWithName:@"itemType"];
[itemType setStringValue:@"1"];
[messageElement addChild:itemType];

// 发送消息
[self.xmppStream sendElement:messageElement];

下一篇章将会讲述 xmpp 连接的一些问题,修改源码来优化连接。

欢迎来一起交流。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 160,026评论 4 364
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,655评论 1 296
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,726评论 0 244
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,204评论 0 213
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,558评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,731评论 1 222
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,944评论 2 314
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,698评论 0 203
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,438评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,633评论 2 247
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,125评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,444评论 3 255
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,137评论 3 238
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,103评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,888评论 0 197
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,772评论 2 276
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,669评论 2 271

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 170,573评论 25 707
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,103评论 18 139
  • 关于XMPP最权威的讲解:http://www.jabbercn.org/RFC3920(这个才是最权威的,下面文...
    随风飘荡的小逗逼阅读 1,425评论 1 5
  • 此时的夜,黑暗而又寂静~湖边漫步,未至深秋的冷风早已把我包围,扣上衬衫最后一颗纽扣,希望能给自己带来哪怕一丝的...
    花开逸墨阅读 228评论 0 0
  • 这个人是我生生赚来的。 当初阴差阳错来到这个单位,一切都冒着陌生的气味。一次兄弟单位聚餐间隙,在乒乓球台边的我没忍...
    菌118阅读 429评论 0 2