程序员

XMPPFramework开发(二):工程配置以及登录注册

搞事前言


在前面一篇博客中说到关于Openfire的服务器的搭建,这一篇博客就从登录注册开始搞起,其实发现很多网上的XMPPFramework的使用博客都是简单的说一下其中的各种代理方法是干什么用的,各种界面之间的逻辑没有较为详细的讲解,所以骚栋准备从XMPPFramework中各种代理方法的使用情况以及一个简单的聊天App的逻辑实现,进行详细的说明讲解.恩恩,对于自己写的示例SDChat也是写了好几天了,其中还是存在不少的Bug.我准备同步更新,一边改Bug的同时,一边更新博客.希望大家谅解.

XMPPFramework的工程配置


  • XMPPFramework这个我没有使用cocospod,而是直接手动导入了文件夹.大家可以直接从SDChat中把XMPPFramework的拖到自己的工程中去,也可以从Github上源码原处下载.

  • 我们把XMPPFramework导入工程之后,我们需要手动导入如下的两个库.

    libxml2.tbd
    libresolv.tbd

  • 上面的基本就配置完成了,但是我们需要把服务器文件XMPPConfig.h配置完成.我们在工程中需要的配置项目有这么几个,分别是服务器的IP地址、服务器的的端口(默认的为5222),openfire的服务器名称、resource(资源,这个可以自行定义).

    服务器名称我们可以登录openfire的管理页面中,进行查看和修改.

    如果openfire的服务器是搭建在mac上的话,服务器的IP地址可以在网络偏好设置中进行查看.

    配置的过程有两点是需要注意的,一、如果openfire的服务器是搭建在mac上的话,服务器和移动端必须要在同一局域网内.否则,应用是连接不上服务器的.二,每一次mac的无线网络的变动,IP都有可能发生改变,如果后期连接不上,请注意查看是否是openfire的服务器的IP发生了改变.

配置完成的示例如下所示.

#ifndef XMPPSample_XMPPConfig_h
#define XMPPSample_XMPPConfig_h

// openfire服务器IP地址
#define  kHostName      @"192.168.3.18"

// openfire服务器端口 默认5222
#define  kHostPort      5222
// openfire服务器名称
#define kDomin @"127.0.0.1"
// resource(资源)
#define kResource @"ios"

#endif
  • 对于info.plist文件其实也是需要一些相关的修改的,但是基本上和XMPPFramework没有太大的关系,我们会在具体模块中进行说明.

XMPPFramework的登录功能实现


由于XMPPFramework的功能比较多,所以我们需要添加一个管理单例SDXmppManager,管理XMPPFramework所有的功能.我们在SDXmppManager.h文件中导入#import "XMPPFramework.h".

我们先一瞅SDchat中登录界面的骚包风采.~~~

在XMPPFramework中,登录注册功能主要是由XMPPStream这个类来完成的.我们在SDXmppManager单例中创建一个XMPPStream对象属性用来管理整个应用的登录注册.

@property(nonatomic,strong)XMPPStream *stream;

然后我们在单例初始化的过程中对XMPPStream对象属性进行初始化,设置IP地址以及端口号,并且指定代理对象.

 self.stream = [[XMPPStream alloc]init];
 self.stream.hostName = kHostName;
 self.stream.hostPort = kHostPort;
  //设置stream的代理
  [self.stream addDelegate:self delegateQueue:dispatch_get_main_queue()];

好了,基本的准备工作就做完了,接下来.我们先看一下具体登录流程图,然后在比对着SDChat中的登录操作代码进行详细的说明.(流程图尺寸有点大,如果看不清楚,请先下载到本地在查看.)

流程图中基本所有的代码操作都是在SDXmppManager这个单例中完成的.登录首先其实主要分为两大步,第一步先连接服务器,第二步验证密码.流程图把两大部分拆分成好多小的步骤.

我们先看一下如何连接服务器.如下代码所示,我们需要判断是否已经连接到服务器了.如果已经连接是需要先断开连接的,然后使用登录账号,服务器名称,资源名称(可省略)配置成基于jabber协议的由用户名生成的唯一ID,并配置到stream中去.然后调用- (BOOL)connectWithTimeout:(NSTimeInterval)timeout error:(NSError **)errPtr方法连接服务器.

//与服务器的建立链接
-(void)connectToServerWintUser:(NSString *)name{

    if ([self.stream isConnected]) {

        [self.stream disconnect];

    }

    //jid jabberID,是基于jabber协议的由用户名生成的唯一ID
    self.stream.myJID = [XMPPJID jidWithUser:name domain:kDomin resource:kResource];

    NSLog(@"%@",self.stream.myJID);
    NSError *error = nil;

    //与服务器建立链接.
    [self.stream connectWithTimeout:30.0f error:&error];

    if (error != nil) {

        NSLog(@"连接失败!");
    }

}

上面如果验证成功之后,就会调用XMPPStream的-(void)xmppStreamDidConnect:(XMPPStream *)sender这个代理方法,我们需要在这里面进行验证密码.验证密码比较简单只需要调用[self.stream authenticateWithPassword:self.password error:&error];这一句代码即可.具体情况如下.因为注册和登录类似,所以两者需要放在了一起.

//与服务器建立连接
-(void)xmppStreamDidConnect:(XMPPStream *)sender{
    NSError *error = nil;
    switch (self.type) {
        case DoLgin:

            [self.stream authenticateWithPassword:self.password error:&error];
            if (error != nil) {
                NSLog(@"认证过程出错!");
            }

            break;

        case DoRegiser:

            [self.stream registerWithPassword:self.regiserPassword error:&error];
            if (error != nil) {
                NSLog(@"注册过程出错!");
            }

            break;
    }

}

验证完成之后,我们需要进行一些界面跳转、用户登录状态的修改以及保存密码和JID的操作,这些我是放在SDLoginVC这个控制器进行的,SDLoginVC这个控制器是登录界面的控制器.继承于SDLaunchViewController,这是我以前写的可以做动态背景的页面的控制器,感兴趣的童鞋可以点击这里看看.在SDLaunchViewController这个控制器中是有计时器的,所以我们在页面跳转的时候要把计时器(rollTimer和timer)及时的释放掉.

//登录成功!跳转页面(代理实现)
- (void)xmppStreamDidAuthenticate:(XMPPStream *)sender{

    XMPPPresence *presence =  [XMPPPresence presenceWithType:@"available"];

    [[SDXmppManager defaulManager].stream sendElement:presence];

    [SDUser defaulUser].jid =[XMPPJID jidWithUser:self.userName.text domain:kDomin resource:kResource];
    [SDUser defaulUser].password = self.passWord.text;
    [[SDXmppManager defaulManager].roster fetchRoster];


    if (self.timer !=nil) {

        [self.timer invalidate];
        self.timer = nil;
    }

    if (self.rollTimer != nil) {
        [self.rollTimer invalidate];
        self.rollTimer = nil;
    }
    self.view.window.rootViewController = self.contactNC;

}

登录成功之后,我们就可以对好友列表信息和个人信息进行获取了.这个会在后面的博客中说到.登录的基本流程就是这样了.下面我们看一下注册功能的实现.

XMPPFramework的注册功能实现


SDChat中注册界面如下所示,其实用户名称并没有用到,这样的注册界面在用户头像那部分也是出现了Bug的.下一步着重处理.

注册的逻辑和登录的逻辑基本是相同的,也是两大部分,一部分是连接服务器,第二部分则是验证注册密码.主要代码跟登录的基本是一致的,就是验证方法有所不同.沿着密码的方法改为[self.stream registerWithPassword:self.regiserPassword error:&error];;

主要用到的注册成功-(void)xmppStreamDidRegister:(XMPPStream *)sender或者失败-(void)xmppStream:(XMPPStream *)sender didNotRegister:(DDXMLElement *)error代理方法具体代码如下所示.我们在注册成功的方法中进行了页面的跳转,在失败的方法中进行了用户的提醒.

//当注册成功的时候进行调动
-(void)xmppStreamDidRegister:(XMPPStream *)sender{

    UIAlertController *alertView = [UIAlertController alertControllerWithTitle:nil message:@"注册成功!" preferredStyle:UIAlertControllerStyleAlert];
    __weak typeof(self)temp = self;
    UIAlertAction *action = [UIAlertAction actionWithTitle:@"返回登录" style:UIAlertActionStyleDefault handler:^(UIAlertAction * _Nonnull action) {

        [temp popLoginVC];

    }];

    [alertView addAction:action];

    [self presentViewController:alertView animated:YES completion:nil];
}
//当注册不成功的时候进行调用
-(void)xmppStream:(XMPPStream *)sender didNotRegister:(DDXMLElement *)error{

    [self showAlertViewWithMessage:@"注册失败~,请检查服务器"];
}

注册完成之后,我们还可以进行个人名片的设置等操作.后期将在个人的电子模块这个部分将会说到.今天就不过多的说明了.

结束


说到这里基本上XMPPFramework的工程配置以及登录注册相关的知识就说完了,下一篇博客骚栋将对XMPPFramework开发过程中好友列表的获取进行详细的说明.最后把SDChat的传送门送给大家,大家也可以自己先看一下,如果有任何问题,欢迎联系骚栋,谢谢大家了.

–>SDChat传送门🚪