iOS開發之使用XMPPFramework實現即時通訊(二)
上篇的部落格只是本篇的引子,本篇部落格就給之前的微信加上即時通訊的功能,主要是對XMPPFramework的使用。本篇部落格中用到了Spark做測試,當然也少不了Openfire伺服器,在這就不詳述Openfire的安裝過程了(網上的教程還是蠻多的),Openfire的安裝僅需要一個數據庫的支援,本篇是用的MySql資料庫。當然這不是本篇的重點。
廢話少說,切入今天的正題。今天要給之前的微信加入登陸,獲取好友列表,聊天(傳送文字,表情,圖片,聲音等功能),最近聯絡人等。在部落格的開頭還是先來幾張圖來介紹一下功能,然後再給出核心程式碼的實現。
一、功能模組截圖
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 }
至於如何在TableView上顯示FetchedResultController獲取的資料,請參考之前的部落格:
最近聯絡人的程式碼和歷史表情的程式碼類似,請參考之前的部落格:
今天的XMPPFramework就先到這兒吧,內容也挺多的了,其實XMPPFramework中的元件使用方法都差不多,首先第初始化記憶體,然後進行相關配置,在後就是在XMPPStream中啟用,最後就是如何使用了。