基于XMPP协议来实现通信

关于XMPP的理论介绍在本篇博客中就不做赘述了，如何在我们之前的微信中加入XMPP协议来实现通信呢？下面将会介绍一下XMPP的基本的知识，让我们的微信可以实现互联通信。要做的准备工作是要有服务器支持XMPP协议，然后通过spark注册个测试账号，最后就可以通过XMPP用我们已有的账号和密码进行通信啦。至于如何使服务器支持XMPP协议，如何通过Spark注册账号，不是本篇博客的论述主题，本篇博客中主要是如何在我们的App中使用XMPP协议。

　　今天的博客中的内容是如何在工程中引入XMPPFramework，并在App上可以连接并认证我们的账户和密码，好啦，废话少说，切入今天的正题。

　　一.XMPPFramework的引入

　　　　1.使用XMPP当然少不了框架的导入，还是用CocoaPods来管理第三方类库，在对应的工程中用CocoaPods引入XMPPFramework, 在Profile中添加相应版本的XMPPFramework框架，然后pod update一下安装即可，终端截图如下:

　　　　2.update成功以后我们就可以用XMPPFramework干活了

 

　　二.使用XMPPFramework连接服务器并认证密码

　　　　1.在AppDelegate中声明并实例化XMPPStream，在获取XMPPStream实例时，和CoreData中的managedObjectContext类似，下面会给出代码，

　　　　　　初始化XMPPSteam代码如下：

1 //XMPP数据流
2 @property (strong, nonatomic) XMPPStream * xmppStream;
3 
4 
5  //创建xmppstream
6  self.xmppStream = [[XMPPStream alloc]init];

 

　　　　2.在使用XMPPFramework时，因为其用到是委托回调，所以要在相应的Controller中实现XMPPStreamDelegate协议，然后实现协议中相应的方法。

　　　　　　(1).在使用XMPPStream的Controller中通过Application的delegate获取我们上面创建的xmppStream实例，代码如下：

1     //获取应用的xmppSteam(通过Application中的单例获取)
2     UIApplication *application = [UIApplication sharedApplication];
3     id delegate = [application delegate];
4     self.xmppStream = [delegate xmppStream];
5     
6     //注册回调
7     [self.xmppStream addDelegate:self delegateQueue:dispatch_get_main_queue()];

 

　　　　　(2)获取XMPP流以后,就可以连接服务器了,连接服务器分为三部分，先拼接XMPPJID, 然后把JID添加到xmppStream中，最后连接。代码如下：

 1 //连接服务器
 2 -(void) xmppConnect
 3 {
 4     //1.创建JID
 5     XMPPJID *jid = [XMPPJID jidWithUser:@"lizelusdut" domain:MY_DOMAIN resource:@"iPhone"];
 6     
 7     //2.把JID添加到xmppSteam中
 8     [self.xmppStream setMyJID:jid];
 9     
10     //连接服务器
11     NSError *error = nil;
12     [self.xmppStream connectWithTimeout:10 error:&error];
13     if (error) {
14         NSLog(@"连接出错：%@",[error localizedDescription]);
15     }
16 }

 

　　　　（3）实现连接服务器后要回调的方法（连接后要认证用户密码），代码如下

 1 //连接后的回调
 2 -(void)xmppStreamDidConnect:(XMPPStream *)sender
 3 {
 4     //连接成功后认证用户名和密码
 5     NSError *error = nil;
 6     [self.xmppStream authenticateWithPassword:@"!@#admin" error:&error];
 7     if (error) {
 8         NSLog(@"认证错误：%@",[error localizedDescription]);
 9     }
10 }

 

　　　　（4）实现认证成功后要回调的方法，代码如下：

//认证成功后的回调
-(void)xmppStreamDidAuthenticate:(XMPPStream *)sender
{
    NSLog(@"登陆成功");
}

 

　　　　（5）认证失败后要调用的方法，代码如下：

1 //认证成功后的回调
2 -(void)xmppStream:sender didNotAuthenticate:(DDXMLElement *)error
3 {
4     NSLog(@"登陆失败");
5 }

今天要给之前的微信加入登陆，获取好友列表，聊天(发送文字，表情，图片，声音等功能)，最近联系人等。在博客的开头还是先来几张图来介绍一下功能，然后再给出核心代码的实现。

　　一、功能模块截图

　　　　1.登陆和获取好友列表

　　　　　　登陆的过程就是连接用XMPPFramework连接Openfire的过程，如果用户登陆过，就从UserDefault里获取用户的JID和密码自动连接，如果用户没有登陆过则登陆。获取好友列表也是通过XMPPFramework中的Roster来获取的，运行截图如下：

　　　　2.好友点击去就是聊天页面，聊天时如果是发送的图片或者声音，先存储到服务器上存储，服务器会返回存储路径然后再把URL发送给接收方，接收方再下载

　　　　　　（1）如果是发送的文字，把文字转成属性字符串，然后再转成NSData,最后转成字符串放在Message的Body中进行发送，下面是用Spark做接收端做得测试，截图如下：

 

 

　　　　(2)发送图片，把图片的存储路径发送给对方，让对方从服务器上下载。截图如下：

 

 

　　　　（3）发送声音和图片一样都是发送URL,截图如下：

 

　　二、代码实现部分

　　　　上面的部分是允许的效果截图，从截图上是不难看出功能点的。图就先贴到这吧，下面给出核心代码的实现。

　　　　1.使用XMPPFramework前的准备，获取XmppStream和激活要用的组件,在AppDelegate添加代码。以后要用xmppStream时，要通过AppDelegate获取。下面的代码是在AppDelegate.m中进行的相关组件的初始化，代码如下

　　　　　　(1)实例化XMPPStream

    //创建xmppstream
    self.xmppStream = [[XMPPStream alloc]init];

 

　　　　　　(2)创建重连组件，并在xmppStream中激活

1   //创建重写连接组件
2     xmppReconnect= [[XMPPReconnect alloc] init];
3     //使组件生效
4     [xmppReconnect activate:self.xmppStream];

 

　　　　　　(3)创建message部分的内容，接受的消息我们保存在本地数据库中，我们要显示的时候是从数据库中获取的。在初始化消息组件的时候，要指定保存策略，一般可以选的是CoreData还是内存。指定完保存策略后实例化Message是要关联保存策略，之后也是需要在XMPPStream中进行激活的,最后要获取CoreData的上下文。代码如下：

1     //创建消息保存策略（规则，规定）
2     messageStorage = [XMPPMessageArchivingCoreDataStorage sharedInstance];
3     //用消息保存策略创建消息保存组件
4     xmppMessageArchiving = [[XMPPMessageArchiving alloc]initWithMessageArchivingStorage:messageStorage];
5     //使组件生效
6     [xmppMessageArchiving activate:self.xmppStream];
7     //提取消息保存组件的coreData上下文
8     self.xmppManagedObjectContext = messageStorage.mainThreadManagedObjectContext;

 

　　　　　　(4)，初始化获取好友列表的相关组件并指定保存策略，和上面的代码步骤极为相似。这也能看出来在XMPPFramework中进行组件的初始化步骤是差不多的。下面我们设定自动获取花名册，代码如下：

1     xmppRosterStorage = [[XMPPRosterCoreDataStorage alloc] init];
2     xmppRoster = [[XMPPRoster alloc] initWithRosterStorage:xmppRosterStorage];
3     //自动获取用户列表
4     xmppRoster.autoFetchRoster = YES;
5     xmppRoster.autoAcceptKnownPresenceSubscriptionRequests = YES;
6     
7     [xmppRoster activate:self.xmppStream];
8     self.xmppRosterManagedObjectContext = xmppRosterStorage.mainThreadManagedObjectContext;

 

　　　　2.登陆模块的实现

　　　　　　登陆时就是用户输入JID和Password,然后连接服务器和验证密码，如果认证成功则跳转到好友列表才Controller，同时把JID和Password存储到UserDefaults中便于下次自动连接。下面的代码就是登陆部分的代码(LoginViewController.m)：

　　　　　　(1).通过应用代理获取XMPPStream,并注册回调，代码如下：

 1 -(void) initXmpp
 2 {
 3     //获取应用的xmppSteam(通过Application中的单例获取)
 4     UIApplication *application = [UIApplication sharedApplication];
 5     id delegate = [application delegate];
 6     self.xmppStream = [delegate xmppStream];
 7     
 8     //注册回调
 9     [self.xmppStream addDelegate:self delegateQueue:dispatch_get_main_queue()];
10 }

 

　　　　　　(2).创建JID连接服务器

 1 //连接服务器
 2 -(void) xmppConnect
 3 {
 4     if (![self.userNameTextFiled.text isEqualToString:@""] && self.userNameTextFiled.text != nil)
 5     {
 6         //1.创建JID
 7         XMPPJID *jid = [XMPPJID jidWithUser:self.userNameTextFiled.text domain:MY_DOMAIN resource:@"iPhone"];
 8         
 9         //2.把JID添加到xmppSteam中
10         [self.xmppStream setMyJID:jid];
11         
12         //连接服务器
13         NSError *error = nil;
14         [self.xmppStream connectWithTimeout:10 error:&error];
15         if (error)
16         {
17             NSLog(@"连接出错：%@",[error localizedDescription]);
18         }
19 
20     }
21     else
22     {
23         UIAlertView *alter = [[UIAlertView alloc] initWithTitle:@"提示" message:@"用户名不能为空" delegate:nil cancelButtonTitle:@"取消" otherButtonTitles:nil];
24         [alter show];
25     }
26 }

 

　　　　　　(3).连接成后需要认证密码，代码如下：

 1 //连接后的回调
 2 -(void)xmppStreamDidConnect:(XMPPStream *)sender
 3 {
 4     if (![self.passwordTextFiled.text isEqualToString:@""] && self.passwordTextFiled.text != nil)
 5     {
 6         //连接成功后认证用户名和密码
 7         NSError *error = nil;
 8         [self.xmppStream authenticateWithPassword:self.passwordTextFiled.text error:&error];
 9         if (error)
10         {
11             NSLog(@"认证错误：%@",[error localizedDescription]);
12         }
13     }
14     else
15     {
16         UIAlertView *alter = [[UIAlertView alloc] initWithTitle:@"提示" message:@"密码不能为空" delegate:self cancelButtonTitle:@"取消" otherButtonTitles:nil];
17         [alter show];
18     }
19 }

 

　　　　　　(4)密码认证成功后的回调

 1 //认证成功后的回调
 2 -(void)xmppStreamDidAuthenticate:(XMPPStream *)sender
 3 {
 4     NSLog(@"登陆成功");
 5     
 6     //密码进入userDefault
 7     NSUserDefaults *userDefult = [NSUserDefaults standardUserDefaults];
 8     [userDefult setObject:self.userNameTextFiled.text forKey:@"username"];
 9     [userDefult setObject:self.passwordTextFiled.text forKey:@"password"];
10     
11     //设置在线状态
12     XMPPPresence * pre = [XMPPPresence presence];
13     [self.xmppStream sendElement:pre];
14     
15     UIStoryboard *storybard = [UIStoryboard storyboardWithName:@"Main" bundle:[NSBundle mainBundle]];
16     UIViewController *viewController = [storybard instantiateViewControllerWithIdentifier:@"mainController"];
17     [self presentViewController:viewController animated:YES completion:^{
18     }];
19 }

 

　　　　　　(5)密码认证失败后的回调

1 //认证失败的回调
2 -(void)xmppStream:sender didNotAuthenticate:(DDXMLElement *)error
3 {
4     NSLog(@"认证失败");
5 }

 

　　　　　　(6),二次登陆自动连接代码：

 1    // 如果已登录就直接填充密码登陆
 2     NSUserDefaults *userDefult = [NSUserDefaults standardUserDefaults];
 3     
 4     NSString *userName = [userDefult objectForKey:@"username"];
 5     NSString *password = [userDefult objectForKey:@"password"];
 6     NSLog(@"%@,%@",userName,password);
 7     if (userName != nil && password != nil && ![userName isEqualToString:@""] && ![password isEqualToString:@""])
 8     {
 9         self.userNameTextFiled.text = userName;
10         self.passwordTextFiled.text = password;
11         [self xmppConnect];
12     }

　　　　

　　　　3.获取好友列表的XMPPFramework的代码实现

　　　　　　在获取用户列表的代码中就会用到我们之前注册的Roster的内容，因为我们在实例化Roster的时候指定的保存策略是用CoreData进行保存的，并且是自动获取好友列表。所以在获取好友列表的TableViewController中我们只需要通过CoreData来获取好友列表即可。下面将给出获取好友列表的核心代码：

　　　　　　(1),获取Roster对应的上下文，用于获取存储在Roster相应实体中的数据

1     //获取Roster的上下文
2     UIApplication *application = [UIApplication sharedApplication];
3     id delegate = [application delegate];
4     self.xmppRosterManagedObjectContext = [delegate xmppRosterManagedObjectContext];

　　　　　　

　　　　　　(2).获取FetchRequst对象，并指定CoreData实体类，之后添加排序规则，代码如下：

1     //从CoreData中获取数据
2     //通过实体获取FetchRequest实体
3     NSFetchRequest *request = [[NSFetchRequest alloc] initWithEntityName:NSStringFromClass([XMPPUserCoreDataStorageObject class])];
4     //添加排序规则
5     NSSortDescriptor * sortD = [NSSortDescriptor sortDescriptorWithKey:@"jidStr" ascending:YES];
6     [request setSortDescriptors:@[sortD]];

　　

　　　　　　(3).获取FetchedResultController并注册回调，用于自动刷新TableView,代码如下：

1     //获取FRC
2     self.fetchedResultsController = [[NSFetchedResultsController alloc] initWithFetchRequest:request managedObjectContext:self.xmppRosterManagedObjectContext sectionNameKeyPath:nil cacheName:nil];
3     self.fetchedResultsController.delegate = self;

 

　　　　　　(4)获取存储的内容

1     
2     //获取内容
3     NSError * error;
4     ;
5     if (![self.fetchedResultsController performFetch:&error])
6     {
7         NSLog(@"%s  %@",__FUNCTION__,[error localizedDescription]);
8     }