XMPP之Roster（花名册）模块

如之前所说，建议建立一个XMPPStream单例对象，然后再在这个单例对象中进行模块添加，当然使用其他你认为合适的方式进行下面的模块添加也是OK的

如果你是用pod初始化的项目，那么在项目中的XMPPFramework文件夹下可以直接看到Roster目录

1，导入头文件

#import "XMPPRoster.h"
#import "XMPPRosterCoreDataStorage.h"

2， 模块添加

//花名册模块
_rosterStorage = [XMPPRosterCoreDataStorage sharedInstance];
_roster = [[XMPPRoster alloc] initWithRosterStorage:self.rosterStorage];
[self.roster activate:_xmppStream];

3，花名册模块使用：

如果需要使用模块，需要把模块相应的对象暴漏到头文件中方便我们之后调用
在本模块中需要暴漏的是XMPPRoster对象和XMPPRosterCoreDataStorage，前者用来设置代理以监听好友请求等，后者需要用来获取数据上下文，进行数据查询，具体如下：

//3.1, 从数据库中取值（CoreData数据库文件在工程中是在XMPPFramework文件夹下的Resources文件夹里）

//1，获取上下文，可以直接从rosterStorage中获取
NSManagedObjectContext *context = [IMStream sharedStream].rosterStorage.mainThreadManagedObjectContext;

//2，创建请求并设置过滤条件以及排序等
//注意：所有当前用户的好友的streamBareJidStr字段内容都是当前用户的jid字符串
//这个是需要查询的表：XMPPUserCoreDataStorageObject
NSString *account = [[NSUserDefaults standardUserDefaults] objectForKey:@"account"];
NSString *jid = [NSString stringWithFormat:@"%@@192.168.0.2", account];

NSFetchRequest *request = [NSFetchRequest fetchRequestWithEntityName:@"XMPPUserCoreDataStorageObject"];
NSPredicate *predicate = [NSPredicate predicateWithFormat:@"streamBareJidStr = %@",jid];
NSSortDescriptor *sortDescriptor = [NSSortDescriptor sortDescriptorWithKey:@"displayName" ascending:YES];
request.predicate = predicate;
request.sortDescriptors = @[sortDescriptor];

/*
//第一种执行请求的方式是CoreData的方式，这种方式是不能实时监听好友列表的改变的
NSError *error;
self.contacts = [context executeFetchRequest:request error:&error];
 */

//3.1,第二种是用XMPP提供的执行请求方式，可以实时监听好友添加删除变化
self.fetchController = [[NSFetchedResultsController alloc] initWithFetchRequest:request managedObjectContext:context sectionNameKeyPath:nil cacheName:nil];
//3.2，设置代理方便监听
self.fetchController.delegate = self;
//3.3，真正的执行请求得到数据
NSError *error;
[self.fetchController performFetch:&error];
if (error) {
    NSLog(@"%@",error);
}

• 3.2，解析查询的结果

//如果没有错误，说明请求正确，那么就可以拿到请求到的数组结果了
NSLog(@"%@",self.fetchController.fetchedObjects);
//下面是取出第一个内容的例子
XMPPUserCoreDataStorageObject *userObject = self.fetchController.fetchedObjects[0];

• 3.3，在合适的位置进行了数据的查询之后就可以进行数据变化的监听了

//代理方式监听请求内容的变化，我这里是进行刷洗了表格内容
- (void)controllerDidChangeContent:(NSFetchedResultsController *)controller{
    NSLog(@"数据发生变化：添加了好友或者被好友删除了等");
    [self.tableView reloadData];
}

• 3.4，监听好友添加请求,需要设置XMPPRoster代理为自己，然后实现监听方法即可，监听方法如下：

-(void)xmppRoster:(XMPPRoster *)sender didReceivePresenceSubscriptionRequest:(XMPPPresence *)presence{
    NSLog(@"接受到好友请求");
}

4，释放模块，当你不需要再使用这个模块的时候可以释放掉这个模块（在单例中貌似没有这个必要，可以在控制器死亡的时候进行释放，具体放在那里看具体情况）

//首先冻结模块
[_roster deactivate];
//然后把对象设置为nil
_rosterStorage = nil;
_roster = nil;