XMPPFramework

最新推荐文章于 2021-01-19 17:20:06 发布
最新推荐文章于 2021-01-19 17:20:06 发布
阅读量2k 收藏 1
点赞数
分类专栏： XMPP

XMPPFramework

XMPP Framework概述

XMPP Framework是一个开源的，objective-c实现的xmpp应用开发框架，一般用于开发iOS上的聊天应用。采用模块化的设计。框架分为两个部分，核心和扩展。

历史

XMPP framework启动于2008年，一开始是作为RFC3920的一个简单实现。它提供一个小型代理系统，用于接收3种xmpp节（presence, message, iq）。

为了可以容易的把xmpp framework包含进其它工程，代码被编译成一个objective-c framework。然而，因为这个framework只提供了一个最低限度的功能，

想要用它完成某个有用的东西，第3方开发者就得提供很多额外的代码。毕竟，大部分使用xmpp的应用程序都需要一些额外的功能，例如：rosters, capabilities,

或者是其它上百个XEP's中的任何一个。

显然，该项目需要提供更多通用功能的实现。Roster和一些其它的XEP‘s被添加进来。在早期阶段，这些附加功能彼此叠加在一起，整个设计显得很臃肿。此外，

第3方开发者开始提供附加的XEP实现。但是要把他们的实现添加进这个庞大的架构里面，简直是一场恶梦。而且有些额外的功能常常不是开发者想要的。对于

每一个XEP，一般都是只有特定比例的应用程序才需要。可以理解，第3方开发者想要一个简单优雅、灵活的设计（只具备开发者想要的功能），而不是一个庞大

臃肿的设计。

因此，该项目的第二版诞生了，并引入了模块化的设计。该项目被分为核心系统，和一系列增加附加功能的模块。开发者可以只插入他们想要的功能。这样，第3

方开发者想要为该项目做点贡献，就简单多了。开发者也可以通过只包含他们想要的模块来保持精简代码。

正是在这一点上，开发一个通用的objective-c框架的概念消失了。不在采用庞大的架构，但是保留了一个整体的框架。因此，第3方开发者开始只包含他们需要到

的文件，或者是定制他们自己的编译来包含他们想要的文件。此外，许多新的开发者开始在不支持non-apple框架的iPhone apps中使用该项目。最后，单一的框架

也消失了，取而代之的是一份说明如何定制你的xmpp栈的文档。然而该项目的名字定下来了，仍然称之为“XMPP Framework”。

第三版继续遵循模块化来构建，加入了核心线程安全，使之更容易与各个模块并行执行。

介绍

提示：该文档主要解释XMPPFramework的架构。假定你对xmpp协议有所了解。

该框架分为两个部分：

1 xmpp核心

2 扩展部分（roster, XEP's, 可选的支持功能等）

核心部分是xmpp规范的RFC 3920的实现

不要把xmpp等同于“聊天”。XMPP代表“可扩展消息与出席协议”。它是一个多用途的通用协议。实际上目前有很多公司把该框架用于诸如住宅自动化，和医院里给护士发警报。

扩展部分包括roster支持，自动重连，和各个xmpp扩展的实现。

XMPP核心

XMPP Framework的核心文件位于"Core"文件件下面。这些文件包括：

  • XMPPStream
  • XMPPParser
  • XMPPJID
  • XMPPElement
  • XMPPIQ
  • XMPPMessage
  • XMPPPresence
  • XMPPModule
  • XMPPLogging
  • XMPPInternal
框架的核心是XMPPStream这个类，这是你将要交互的最主要的类，所有的扩展和定制代码都要插入到这个类中。它有许多有趣的功能，这些功能是被设计

来使该框架灵活、可扩展、易于做二次开发的。

XMPPParse是XMPPFramework使用的一个内部类，你或许可以猜到它是做什么的。你不需要与它交互。

XMPPJID提供了一个不可变更的JID实现。它支持JID的过滤，以及与多种形式提取JID的各个部分。它遵守NSCopying 协议， 所以JID可以用作NSDictionary的

键。它甚至还遵守NSCoding 协议。

XMPPElement 是3中XMPP元素：XMPPIQ, XMPPMessage & XMPPPresence的基类。XMPPElement扩展了NSXMLElement。

你的NSXML 基础可以派上用场了。

XMPPModule是一个基类，任何可插式扩展应该继承它。如果你正在写你的应用私有代码，你将可能创建你的类，并且注册以收到委托调用。

然而，如果你正在实现标准的XEP，或者你希望你的应用私有扩展是可插式的，那么你就要在XMPPModule之上构建。

XMPPLogging提供了一个非常快的，强大并且灵活的日志框架。

XMPPInternal是与核心和各种高级底层扩展相关的内部模块。

Elements: IQ, Message, & Presence

XMPPElement扩展自NSXMLElement.所以NSXML 的所有接口对于XMPPElement都适用。

  • XMPPIQ -> XMPPElement -> NSXMLElement -> NSXMLNode -> NSObject
  • XMPPMessage -> XMPPElement -> NSXMLElement -> NSXMLNode -> NSObject
  • XMPPPresence -> XMPPElement -> NSXMLElement -> NSXMLNode -> NSObject
除了NSXML接口，该框架还提供了 NSXMLElement+XMPP类别，该类别提供了多种便利的方法，使你的代码可以更简洁和易读。例如： 

[element attributeIntValueForName:@"age"];

XMPPStream 配置

xmpp stream实例的配置可以分为多个部分：

  • 配置连接xmpp服务器的方式
  • 添加代理
  • 添加模块
  • 连接
  • 验证
配置连接

对于大多数人，只需要一步 - 设置stream的JID属性。例如：

xmppStream.myJID = [XMPPJID jidWithString:@"user@gmail.com"];
xmpp stream将根据XMPP RFC推测出其余部分。这涉及到一个 _xmpp-client._tcp.domain的SRV查询（ SRV查询 - 查询哪台服务器提供某种服务）。

在上面的例子中，使用了gmail，google服务器可能返回“talk.google.com”这样的东西，然后xmpp stream将连接到该服务器。如果SRV查询失败，

xmpp stream就简单的连接到JID指定的domain。

如果你知道你将要连接的xmpp server没有xmpp SRV记录，你可以通过指定hostName来告诉xmpp stream跳过SRV查询。例如：

xmppStream.myJID = [XMPPJID jidWithString:@"user@myCompany.com"];
xmppStream.hostName = @"myCompany.com";
如果你正在使用一个开发xmpp server，hostName也派得上用场。可能服务器是本地网络可见的，或者没有DNS地址等，例如： 

xmppStream.myJID = [XMPPJID jidWithString:@"user@dev1.myCompany.com"];
xmppStream.hostName = @"192.168.2.27";
另一个可选的属性是hostPort。默认情况下，几乎所有的xmpp server都运行在5222端口，xmpp规范也是这样定的。如果你的xmpp server不是运行在

一个不同的端口，你可以设置hostPort属性。

添加代理

XMPPStream有许多有趣的功能，被设计来使该框架灵活、可扩展、易于做二次开发。其中之一就是MulticastDelegate。

什么是MulticastDelegate？

xmpp frameword需要支持不限数量的扩展。这包括框架附带的官方扩展和许多的其它扩展或者你想要插入到框架中的定制代码。所以传统的代理

模式不适用。XMPP模块和扩展需要被分离到它们各自的类中，然而每一个了类都需要收到代理方法。标准的NSNotification架构也不可行，因为其中

一些代理需要返回变量。

因此MulticastDelegate 允许你使用标准的代理模式插入该框架，同时它允许多个类收到同样的代理通知。优美之处在于，你不需要把所有的xmpp处理代码放

在一个单独的类中，你可以把你的处理分离到多个类中，你看怎么合适洛。

你可以在任何时候把自己添加为XMPPStream的代理，也可以在身后时候删除代理。

[xmppStream addDelegate:self delegateQueue:dispatch_get_main_queue()];
...
[xmppStream removeDelegate:self];
添加模块

框架附带了一些扩展，当然，你想写多少扩展就可以写多少。我们不列出所有可用的扩展，这里列举几个作为例子。

  • XMPPReconnect - 意外终止时自动连接stream
  • XMPPRoster - 提供标准的roster支持
  • XMPPRoom -提供多人聊天支持
  • XMPPPubSub - 发布与订阅
以加入XMPPReconnect模块到我们的流中为例： 

xmppReconnect = [[XMPPReconnect alloc] init];

// Optional configuration of xmppReconnect could go here.
// The defaults are fine for our purposes.

[xmppReconnect activate:xmppStream];

// You can also optionally add delegates to the module.

[xmppReconnect addDelegate:self delegateQueue:dispatch_get_main_queue()];

// And that's all that is needed.
// The module will receive any delegate methods it needs automatically
// from the xmpp stream, and will continue to do its thing unless you deactivate it.
连接

准备好之后，就可以开始连接了

NSError *error = nil;
if (![xmppStream connect:&error])
{
    NSLog(@"Oops, I probably forgot something: %@", error);
}
如果你忘了设置必须的属性，比如myJID，那么connect将放回NO，error消息将通知你这个问题。

在连接的过程中，xmpp客户端和xmpp服务器完成了xmpp握手。在此期间，服务器通知客户端它支持的协议和它要求的协议。

一些服务器可能需要连接时安全的（通过SSL/TSL, startTLS）。如果是这样，xmpp stream将自动采用安全连接。如果你正在

连接一个使用了不合适的X509证书的服务器，你可能需要实现xmppStream: willSecureWithSettings: 改变默认安全设置的代理

方法。

验证

所有的连接握手完成之后，xmppStreamDidConnect: 这个代理方法被调用。这一般是大部分客户端开始认证过程的地方。这很

简单，如下所示：

- (void)xmppStreamDidConnect:(XMPPStream *)sender
{
    [xmppStream authenticateWithPassword:password error:NULL];
}
XMPP日志

xmpp framework日志需要达到如下目标

支持多个日志级别

对文件可配

对终端用户可配


XEPs

XEPs是XMPP的标准扩展

XMPPFramework支持的XEPs包括

  • XEP-0009: 两个实体间传输XML-RPC编码的请求和响应
  • XEP-0012: 传达与XMPP实体相关的最后活动信息
  • XEP-0016: 允许或阻止与网络上其它实体的通信 -- 比如实现黑名单的功能
  • XEP-0045: 多人聊天，聊天室
  • XEP-0054: vCard-XML格式的规范文档 -- 与名片交换相关
  • XEP-0059: 管理大量结果集，比如限定查询返回数量、前翻或后翻等
  • XEP-0060: 通用发布-订阅功能
  • XEP-0065: 两个实体之间建立带外字节流
  • XEP-0066: 两个实体间交换URLs, 比如一个实体通知另一个实体某个文件的HTTP URL
  • XEP-0082: 日期和时间的标准化表示
  • XEP-0085: 在聊天过程中沟通用户的状态 -- 比如忙碌、离开等
  • XEP-0100: 指定了jabber Client与传统IM服务代理网关交互的最佳实践
  • XEP-0106: JID转义字符显示机制
  • XEP-0115: 广播和动态发现Client, device, 或通用实体的能力
  • XEP-0153: 提供了用于交换用户头像信息的vCard-based协议的历史文档
  • XEP-0172: 交换用户昵称
  • XEP-0174: 无服务器消息 -- 关于两个客户端怎么直接通信
  • XEP-0184: 消息发送收据， 消息发送者可以请求消息已经发送到指定接收者的通知
  • XEP-0199: 通过XML Stream发送应用程序级的pings
  • XEP-0202: 交换实体的本地时间
  • XEP-0203: 通知消息已被延迟发送（因为某个用户离线）
  • XEP-0223: 定义了通过发布-订阅机制永久存储用户私有数据的最佳实践
  • XEP-0224: 如何引起另一个人的注意
  • XEP-0297: 转发XML节
  • XEP-0308: 定义了一种方法，指明这条消息是上一条的校正




行云_
关注
专栏目录
XMPPFramework---登录篇
lizhenlei的博客
03-31 249
开发之前配置： 1.首先安装mysql 2.安装openfire 3.还有需要java运行环境，没有的需要安装jdk 安装向导如下链接（找了好多，这个链接讲的最详细，最全） http://www.it165.net/os/html/201506/13669.html配置成功后，下面我们就可以进行开发了我们需要下载的第三方的库 两种方式：手动导入和cocoapods导入1.手动从githu
xmppFrameWork
04-16
xmpp demo xmpp frame和基本使用方法 里面有demo
xmppframework开发基础
weixin_33949359的博客
08-11 100
xmppframework是XMPP协议的一个objective-c实现.要了解xmppframework, 从这里开始吧：https://github.com/robbiehanson/XMPPFramework/wiki/IntroToFramework XMPPFramework中包含了一个简单的iPhone客户端实现。 在iPhoneXMPP中。在测试这个Demo过程中要注意的地方...
转：xmppframework相关学习
anle9026的博客
11-26 141
【iOS XMPP】使用XMPPFramewok（一）：添加XMPPFramework（XCode 4.6.2） XMPPFramework GitHub:https://github.com/robbiehanson/XMPPFramework 获取源代码 git clonehttps://github.com/robbiehanson/XMPPFramework...
xmppframework
chengyakun11的专栏
02-15 8499
XMPPRoster *xmppRoster;//用户对象   subscribe 订阅 获取好友列表 - (void)queryRoster { NSXMLElement *query = [NSXMLElement elementWithName:@"query" xmlns:@"jabber:iq:roster"]; NSXMLElement *
iOS 的 XMPPFramework 简介
weixin_30672295的博客
12-19 228
XMPPFramework是一个OS X/iOS平台的开源项目，使用Objective-C实现了XMPP协议（RFC-3920），同时还提供了用于读写XML的工具，大大简化了基于XMPP的通信应用的开发。 1. 登录和好友上下线 1.1XMPP中常用对象们 XMPPStream：xmpp基础服务类 XMPPRoster：好友列表类 XMPPRosterCoreDa...
XMPPFramework核心类介绍
dlo8147的博客
06-16 157
XMPPFramework结构 在进入下一步之前，先给大家讲讲XMPPFramework的目录结构，以便新手们更容易读懂文章。我们来看看下图： 虽然这里有很多个目录，但是我们在开发中基本只关心Core和Extensions这两个目录下的类。各个目录主要用来干嘛的？ Authentication：这一看名字就知道与授权验证相关的。 Categories：主要是一些扩展，尤其...
XMPPFramework 介绍
iOS&Android开发
01-23 796
因为想找XMPPFramework的API文档，但是貌似真的不好找，找到一个ebook还收费，所以先把github上它自己的一篇介绍文翻译一下，拿来入个门。 1. 简介 framework被分为两个部分 xmpp core：核心部分extensions：扩展部分，包括roster，XEP’s，supporting utilities XMPP Core 主要的类
xmpp iOS集成xmppframework
sym_summer
01-27 1772
地址 https://github.com/robbiehanson/XMPPFramework    下载。 框架有一些依赖项。你不需要分别添加。他们都在添加XMPPFramework时,就都已经添加了。我们要每个依赖一步一步走过,确保您的项目符合的每一个步骤。 第一个依赖是CocoaLumberjack。这是在整个项目中使用的日志框架。 第二个Co
XMPPFramework（一）简介
fullwonder的专栏
10-29 666
XMPPFramework是根据XMPP协议，用Objective-C语言实现的一个框架。此框架使用GCD构建，是线程安全的并且支持大并发。 一、历史 XMPPFramework起源于2008年，最初的时候，她只是实现了RFC 3920（XMPP的标准），提供了一个很小的delegate用来接收三种类型的XML节点（presence、message、iq）。后来XMPPFramework有实现
XMPPFramework开发(二):工程配置以及登录注册
得不到的永远是骚栋.
01-19 299
搞事前言 在前面一篇博客中说到关于Openfire的服务器的搭建,这一篇博客就从登录注册开始搞起,其实发现很多网上的XMPPFramework的使用博客都是简单的说一下其中的各种代理方法是干什么用的,各种界面之间的逻辑没有较为详细的讲解,所以骚栋准备从XMPPFramework中各种代理方法的使用情况以及一个简单的聊天App的逻辑实现,进行详细的说明讲解.恩恩,对于自己写的示例SDChat也是写了好几天了,其中还是存在不少的Bug.我准备同步更新,一边改Bug的同时,一边更新博客.希望大家谅解. ..
XMPPFramework开发(六):聊天功能和消息回执
得不到的永远是骚栋.
01-19 434
前言 前面我们几篇文章我们一直在说关于XMPPFramework中好友关系相关的东东,今天即时通讯最重要的是什么?通讯聊天呀,所以,我们今天就说一下XMPPFramewor聊天的实现.SDChat比较简陋的聊天界面如下所示. XMPPFramework实现聊天功能的相关方法 在XMPPFramework中实现聊天功能的类主要是XMPPSteam、XMPPMessageArchiving和XMPPMessageArchivingCoreDataStorage,其中XMPPSteam的作用主要是消息..
XMPPFramework开发(一):Openfire服务器搭建
得不到的永远是骚栋.
01-19 602
XMPPFramework开发前言 这两天没有更新博客,这里先对大家说声对不起了.因为这几天一直忙于研究XMPPFramework这个开源框架.XMPPFramework是一个OS X/iOS平台的开源项目,使用Objective-C实现了XMPP协议,同时还提供了用于读写XML的工具.可以帮助我们快速的开发即时通讯功能.XMPPFramework其实以前培训的时候也是有做过的,不过那只是一顿无脑敲,对其原理以及逻辑并没有深入的了解.而且后期开发使用环信、融云三方开发比较多,XMPPFramework..
cocoapods安装XMPPFramework
最新发布
05-05
要将XMPPFramework添加到你的项目中，需要使用CocoaPods。 首先，在终端中进入你的项目目录： ``` cd /path/to/your/project ``` 然后，创建一个名为Podfile的文件： ``` touch Podfile ``` 在Podfile中添加以下内容： ``` platform :ios, '9.0' target 'YourTargetName' do pod 'XMPPFramework' end ``` 将YourTargetName替换为你的Xcode项目中的实际目标名称。 最后，在终端中运行以下命令： ``` pod install ``` 这将下载并安装XMPPFramework。注意，如果你还没有安装CocoaPods，你需要先运行以下命令来安装它： ``` sudo gem install cocoapods ``` 安装完成后，你需要使用.xcworkspace文件打开你的项目，而不是使用.xcodeproj文件。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值