XMPP核心的几个类 :XMPPStream(通讯管道)、XMPPJID(用户标示)、XMPPPresence(出席通知)、XMPPRoster(花名册)
一.登录注册
1.创建单例(XMPPManager)
static XMPPManager *manager = nil;
+ (XMPPManager *)sharedManager{
// GCD 创建单例对象
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
manager = [[XMPPManager alloc] init];
});
return manager;
}
2.配置通讯管道
- (instancetype)init{
self = [super init];
if (self) {
//-----------------配置通信管道---------------
self.stream = [[XMPPStream alloc] init];
// 设置通信管道的目标服务器地址
_stream.hostName = kHostName;
// 设置通信管道的xmpp server端口
_stream.hostPort = kHostPort;
// 设置代理
[_stream addDelegate:self delegateQueue:dispatch_get_main_queue()];
}
return self;
}
3.构造XMPPJID
// 根据一个用户名构造一个xmppjid
XMPPJID *myjid = [XMPPJID jidWithUser:userName domain:kDomin resource:kResource];
// 设置通信管道的jid
_stream.myJID = myjid;
4.连接服务器
if ([_stream isConnected]) {
NSLog(@"已经连接");
[_stream disconnect]; // 断开连接
}
BOOL result = [_stream connectWithTimeout:30 error:nil];
if (result){
NSLog(@"服务器链接成功");
}else{
NSLog(@"服务器链接失败");
}
5.连接服务器常用代理方法
// 服务器连接超时
- (void)xmppStreamConnectDidTimeout:(XMPPStream *)sender{
NSLog(@"服务器连接超时");
}
// 断开连接
- (void)xmppStreamDidDisconnect:(XMPPStream *)sender withError:(NSError *)error{
if (error) {
NSLog(@"%@",error);
}
// 离线消息(下线通知)
XMPPPresence *presence = [XMPPPresence presenceWithType:@"unavailable"];
// 发送下线通知
[_stream sendElement:presence];
}
6.登陆 先连接服务器,再登陆
// 连接成功之后发起登陆事件
[_stream authenticateWithPassword:self.loginPassword error:nil];
7.登陆常用代理方法
// 登陆成功
- (void)xmppStreamDidAuthenticate:(XMPPStream *)sender{
NSLog(@"登陆成功");
// 出席消息(上线通知)
XMPPPresence *presence = [XMPPPresence presenceWithType:@"available"];
// 发送上线通知
[_stream sendElement:presence];
}
// 登陆失败
- (void)xmppStream:(XMPPStream *)sender didNotAuthenticate:(DDXMLElement *)error{
NSLog(@"登陆失败:%@",error);
}
8.注册 先连接服务器,再注册
// 连接成功之后发起注册事件
[_stream registerWithPassword:self.regPassword error:nil];
9.注册常用的代理方法
// 注册成功
- (void)xmppStreamDidRegister:(XMPPStream *)sender{
NSLog(@"注册成功");
}
// 注册失败
- (void)xmppStream:(XMPPStream *)sender didNotRegister:(DDXMLElement *)error{
NSLog(@"注册失败, error:%@",error);
}
二. 好友列表、添加好友、发送消息、接收消息
1.单例中创建花名册的属性 (XMPPRoster 可以处理和好友相关的事:获取好友列表,添加好友,接收好友请求,同意添加好友,拒绝添加好友)
/**
* 好友花名册,用来处理和好友相关的事件
*/
@property(nonatomic, strong) XMPPRoster * roster;
2.初始化一个花名册,并且在通讯管道中激活花名册
//------------------用户花名册----------------
// xmpp为我们提供了一个CoreData存储器
XMPPRosterCoreDataStorage *xrcds = [XMPPRosterCoreDataStorage sharedInstance];
// 创建roster 花名册时,需要给花名册指定一个数据存储的地方(就是XMPPRosterCoreDataStorage)
self.roster = [[XMPPRoster alloc] initWithRosterStorage:xrcds dispatchQueue:dispatch_get_main_queue()];
// 在通讯管道中激活花名册
// 这时就可以通过通讯管道去给服务器发送请求了。
// 然后roster的消息都通过stream间接的发给服务器
[self.roster activate:self.stream];
3.设置花名册代理,在好友列表控制器里面设置,列表控制器遵循代理 XMPPRosterDelegate// 设置代理
[[XMPPManager sharedManager].roster addDelegate:self delegateQueue:dispatch_get_main_queue()];
4.声明一个数组存放好友
@property (nonatomic, strong) NSMutableArray *rosters;
5.花名册常用代理方法
// 开始接收好友列表
- (void)xmppRosterDidBeginPopulating:(XMPPRoster *)sender{
NSLog(@"开始接收好友列表");
}
// 接收完毕
- (void)xmppRosterDidEndPopulating:(XMPPRoster *)sender{
NSLog(@"结束接收好友列表");
}
// 每次接收到一个好友就会走一次这个方法
- (void)xmppRoster:(XMPPRoster *)sender didReceiveRosterItem:(DDXMLElement *)item{
NSString *jid = [[item attributeForName:@"jid"] stringValue];
XMPPJID *xmppjid = [XMPPJID jidWithString:jid resource:kResource];
[self.rosters addObject:xmppjid];
NSIndexPath *indexpath = nil;
if (self.rosters.count == 0) return;
indexpath = [NSIndexPath indexPathForRow:self.rosters.count - 1 inSection:0];
[self.tableView insertRowsAtIndexPaths:@[indexpath] withRowAnimation:(UITableViewRowAnimationLeft)];
}
// 收到添加好友请求 :(同意:[roster acceptPresenceSubscriptionRequestFrom:presence.from andAddToRoster:YES];)
//(拒绝:[roster rejectPresenceSubscriptionRequestFrom:presence.from];)
- (void)xmppRoster:(XMPPRoster *)sender didReceivePresenceSubscriptionRequest:(XMPPPresence *)presence{
XMPPRoster *roster = [XMPPManager sharedManager].roster;
NSString *message = [NSString stringWithFormat:@"%@请求加你为好友", presence.from.user];
UIAlertController *alert = [UIAlertController alertControllerWithTitle:@"好友请求" message:message preferredStyle:(UIAlertControllerStyleAlert)];
UIAlertAction *action1 = [UIAlertAction actionWithTitle:@"同意" style:(UIAlertActionStyleDefault) handler:^(UIAlertAction * _Nonnull action) {
// 同意请求
[roster acceptPresenceSubscriptionRequestFrom:presence.from andAddToRoster:YES];
}];
UIAlertAction *action2 = [UIAlertAction actionWithTitle:@"拒绝" style:(UIAlertActionStyleDefault) handler:^(UIAlertAction * _Nonnull action) {
// 拒绝请求
[roster rejectPresenceSubscriptionRequestFrom:presence.from];
}];
[alert addAction:action1];
[alert addAction:action2];
[self presentViewController:alert animated:YES completion:nil];
}
6.添加好友(添加好友界面)
- (IBAction)actionAdd:(UIButton *)sender {
// 拿到花名册管理类
XMPPRoster *roster = [XMPPManager sharedManager].roster;
// 拼装要添加的好友
XMPPJID *userjid = [XMPPJID jidWithUser:self.txtUserName.text domain:kDomin resource:kResource];
// 添加好友请求
[roster subscribePresenceToUser:userjid];
}
7.建立聊天
7.1 声明属性 (声明一个XMPPJID类型的属性,记录要聊天的对象)
// 当前聊天对象
@property(nonatomic, strong) XMPPJID * jidChatTo;
7.2 选择聊天对象(可视化编程中)
点击好友列表页面中的一个好友,将这个好友的XMPPJID传给聊天页面。
- (void)prepareForSegue:(UIStoryboardSegue *)segue sender:(id)sender {
if ([sender isKindOfClass:[UITableViewCell class]]) {
NSIndexPath *index = [self.tableView indexPathForCell:(UITableViewCell *)sender];
XMPPJID *jid = self.rosters[index.row];
// 属性传值
ChatViewController *chatVC = [segue destinationViewController]; // 获取目标控制器
chatVC.jidChatTo = jid;
}
7.3 声明聊天界面属性
声明聊天相关的控件属性以及其他属性
@property (weak, nonatomic) IBOutlet UITableView *tableChat; // 展示聊天记录
@property (weak, nonatomic) IBOutlet UITextField *txtMessage; // 输入消息内容
@property (weak, nonatomic) IBOutlet UIView *viewInput; // 底部的输入控件
@property (weak, nonatomic) IBOutlet NSLayoutConstraint *constraintBottomFromSuper; // 底部frame约束
@property (nonatomic, strong) NSMutableArray *messages; // 存放聊天信息
7.4 获取聊天记录
单例(XMPPManager)里面声明CoreData的上下文对象属性,以及聊天消息的归档处理类的对象属性
/**
* 消息归档处理类
* 程序关闭后,下次打开还可以再次查看以前的聊天记录
*/
@property(nonatomic, strong) XMPPMessageArchiving * messageArchiving;
/**
* coredata 上下文,用来获取通过messageArchiving归档后存储起来的消息
*/
@property(nonatomic, strong) NSManagedObjectContext * context;
单例对象初始化(init方法)里面对上下文,和归档处理对象的一些操作
//------------------初始化 XMPPMessageArchiving------
// xmppMessageArchiving的主要功能:1、通过通讯管道获取到服务器发送过来的消息。2、将消息存储到指定的XMPPMessageArchivingCoreStorage
// xmpp为我们提供的一个存储聊天消息的coredata仓库
XMPPMessageArchivingCoreDataStorage *xmacds = [XMPPMessageArchivingCoreDataStorage sharedInstance];
// 初始化时,需要给这个归档类指定一个存储仓库
self.messageArchiving = [[XMPPMessageArchiving alloc] initWithMessageArchivingStorage:xmacds dispatchQueue:dispatch_get_main_queue()];
// 在通讯管道中激活
[self.messageArchiving activate:self.stream];
// 获取消息归档类提供的上下文信息
self.context = xmacds.mainThreadManagedObjectContext;
聊天页面里面通过单例中获得的上下文对象,从CoreData中取到聊天记录数据
// 加载所有信息(通过单例类的上下文获取)
- (void)reloadAllMessage{
// 获取上下文信息
NSManagedObjectContext *context = [XMPPManager sharedManager].context;
// xmppMessageArchving : 把接收到得消息归档,归档后的数据类型是:XMPPMessageArchiving_Message_CoreDataObject
NSFetchRequest *fetchRequest = [NSFetchRequest fetchRequestWithEntityName:@"XMPPMessageArchiving_Message_CoreDataObject"];
// 设置断言
// 查找所有的和当前聊天对象的聊天记录
NSPredicate *predicate = [NSPredicate predicateWithFormat:@"bareJidStr = %@",self.jidChatTo.bare];
// 让断言生效
[fetchRequest setPredicate:predicate];
// 获取数据
NSArray *array = [context executeFetchRequest:fetchRequest error:nil];
if (array) {
// 将原来的数据清空
[self.messages removeAllObjects];
}
// 把获取的数据添加到当前数据源中
[self.messages addObjectsFromArray:array];
// 刷新列表
[self.tableChat reloadData];
// 将视图定位到最新的一条消息。
if (array.count > 0) {
NSIndexPath *index = [NSIndexPath indexPathForItem:array.count - 1 inSection:0];
[self.tableChat scrollToRowAtIndexPath:index atScrollPosition:(UITableViewScrollPositionBottom) animated:YES];
}
}
展示聊天内容
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath{
UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"cell" forIndexPath:indexPath];
// 获取对应的消息
XMPPMessageArchiving_Message_CoreDataObject *message = self.messages[indexPath.row];
// 判断是不是自己发出去的
if ([message isOutgoing]) {
cell.textLabel.text = [NSString stringWithFormat:@"我:%@",message.body];
}else{
cell.textLabel.text = [NSString stringWithFormat:@"%@:%@",message.bareJidStr, message.body];
}
return cell;
}
7.5 发送和接收消息
设置通讯管道代理
XMPPStream *stream = [XMPPManager sharedManager].stream;
[stream addDelegate:self delegateQueue:dispatch_get_main_queue()];
通讯管道代理中和发送以及接收消息相关的代理方法
// 收到信息
- (void)xmppStream:(XMPPStream *)sender didReceiveMessage:(XMPPMessage *)message{
NSLog(@"接收到一条消息:%@",message);
[self reloadAllMessage]; // 加载一遍所有的聊天数据
}
// 发送信息
- (void)xmppStream:(XMPPStream *)sender didSendMessage:(XMPPMessage *)message{
NSLog(@"消息【%@】发送成功",message);
[self reloadAllMessage]; // 加载一遍所有聊天数据
}
发送消息
- (IBAction)actionSendMsg:(UIButton *)sender {
XMPPStream *stream = [XMPPManager sharedManager].stream;
// 实例化一个消息类
XMPPMessage *message = [XMPPMessage messageWithType:@"chat" to:self.jidChatTo];
// 设置消息内容
[message addBody:self.txtMessage.text];
// 通过通讯管道发送
[stream sendElement:message];
}
其他:处理键盘弹出相关:
注册键盘frame改变的通知:
// 通过通知中心来观察键盘的frame的变化,当键盘frame发生变化后触发keyboardFrameChange事件
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(keyboardFrameChange:) name:UIKeyboardDidChangeFrameNotification object:nil];
处理方法及键盘回收代理事件:
// 键盘frame改变后触发事件
- (void)keyboardFrameChange:(NSNotification *)sender{
// 键盘改变后的frame
CGRect rect = [[sender.userInfo objectForKey:@"UIKeyboardFrameEndUserInfoKey"] CGRectValue];
// 计算出聊天窗口的底部偏移量
CGFloat height = self.view.frame.size.height - rect.origin.y;
self.constraintBottomFromSuper.constant = height;
}
#pragma mark -UITextFieldDelegate
- (BOOL)textFieldShouldReturn:(UITextField *)textField{
[textField resignFirstResponder];
return YES;
}
网友评论