gloox与xmpp学习



本文为转载,原文连接:http://blog.sina.com.cn/s/blog_49b531af0102e1lz.html

在使用gloox之前，有必要先提一下XMPP协议这个东东。

XMPP协议是一个基于互联网的即时通信标准协议。它采用XML技术，以文本的方式传输即时消息。支持动态自定义扩展应用。与传统的网络协议相比，如QQ等，XMPP协议并不是一个基于二进制方式实现的协议，而是基于XML技术的文本方式，也就是说如果不采用加密技术的话，是可以直接查看发送的消息的。XMPP协议通过定义一些XML的节点关键字，来表明消息发送信息，并与其它协议能够有效的结合，总的说来，XMPP协议是一种很不错的准实时消息协议标准。如果允许，你可以自己定义一个协议出来，只要约定了XML节点关键字，并考虑了消息交换中的各种情况。但是如果没有特别的情况，一般应该是采用XMPP协议标准进行消息交换，同时可以根据自己的特定应用，适当扩展一些节点，并根据自行扩展约定，解析之即可。

那么gloox是用来干嘛的呢？问题很简单，根据前面所述，XMPP协议只是一个协议，一个约定，但本身并没有提供实现方式。也就是说，XMPP协议定义的那些关键字以及发送消息等这些是需要实现的，只要按照XMPP协议来做的话，就可以互通消息了。而gloox就是实现了这样一个协议的开发包，我们可以通过这个开发包，开发自己的应用来。

那么gloox如何实现了XMPP协议的呢，其实它的底层就是一个socket在收发数据，然后将数据进行XML的解析，封装就可以了。如果允许的话，你是可以自己做socket通信的，只要连接到XMPP服务器，然后收发消息就可以了，对收到的消息，将其解析成XML格式，然后再获取需要的信息，对于发消息，也是将要发送的文本消息封装成XMPP协议定义的关键节点，然后利用socket发送就可以了。

当然，如果通过socket通信方式，按XMPP协议要求收发消息是没有任何问题的，可是说实话，真正能把握socket通信是有一定难度的，虽然看起来就那么几个API，要想用好需要时间。而gloox已经做了这一步了，何必要重复发明轮子呢？gloox已经在底层实现了和XMPP服务器的socket通信了，并且提供了二次开发接口，使我们不用考虑底层数据连接等方面的问题，何乐而不为呢？

好了，前面似乎说了些废话，但对于一些东西的本质我认为是有必要清晰的认识一下的，这样我们可以通过本质看现象，呵呵，反过来用也可以。明白了这一点，在使用gloox的API进行二次开发时，就能知其然，也知其所以然了。

这次先从基本的和XMPP协议服务器连接开始，一步一步来。

其实在下载的gloox开发包中，SRC里面有example和test两个目录，该目录下有使用的例子，你可以直接看例子，可以明白如何使用的。我也是通过这些例子，再看源代码中的注释，明白了一些东西的，然后再整理一下，觉得有些收获，所以把它写出来。

要想连接服务器，通常需要下面几个信息：服务器地址(域名或者IP地址)，服务器端口号，用户帐号，用户密码。在XMPP协议中，服务器建议的端口号为5222，如果没其它必要，建议采用该端口号。XMPP的用户帐号别名叫JID，JID 惟一确定进行即时消息和在线状态信息通信的独立对象或实体, 并可兼容其他即时通信系统( 如MSN 等) 相应的实体标识及其在线状态信息。其语法规则为: [节点″@″] 域名[″/″资源], 其中各个域的长度不能超过1 023 字节, 总长度最大为3 071 字节。从JID的定义可以看出来，其实要连接到服务器，JID中就已经含有了服务器的地址，而如果默认采用5222端口号的话，则可以不用提供服务器地址和端口就可以了，而只通过JID就可以和服务器连接上。

我使用的服务器是openfire，故我直接通过openfire的管理端在里面建了几个用户，当然gloox提供了向服务器注册帐号，修改密码以及删除帐号的API，不过我这里暂时不去做这个功能，因为我觉得在实际的项目开发中意义不大，并且如果能将其它的功能理解了，看一下gloox源码中的那个注册的例子，应该是没有任何问题的。

现在假设我已经注册了一个用户名为：userTest@serverTest/test，密码为：testPassword的帐号，后面我将用这个帐号进行和服务器的连接，即登陆。

假设现在你有一个类叫MessageTest，该类中有一个方法叫start()，你打算用这个方法进行登陆，则登陆的代码如下（代码中含有解释）：

#include "include/client.h"

#include "include/connectionlistener.h"

#include "include/disco.h"

#include "include/stanza.h"

#include "include/gloox.h"

#include "include/lastactivity.h"

#include "include/connectiontcpclient.h"

using namespace gloox;

 

#ifndef _WIN32

# include <unistd.h>

#endif

 

#include <stdio.h>

#include <string>

 

#if defined( WIN32 ) || defined( _WIN32 )

# include <windows.h>

#endif

 

//ConnectionListener为一个连接状态信息的//监听器，当连接成功，或者失败时，都

//会调用该监听器中的该方法。如果你对连接状态信息不感兴趣，可以不用继承该

//类，认为连接肯定是成功的。但一般的使用是，需要继承该接口，并实现其中的三个

//虚函数。

class MessageTest : public ConnectionListener

{

public:

    MessageTest() {}

    virtual ~MessageTest() {}

    void start()

    {

       //初始化一个JID，即用户ID

      JID jid( "userTest@serverTest/test" );

//创建一个连接客户端，后一个参数为密码

      j = new Client( jid, "testPassword" );

//注册连接状态监听器，当调用该方法后，

//gloox会在后台自动调用该接口实现中的相应方法。

      j->registerConnectionListener( this );       //因为this中实现了ConnectionListener接口

//设置服务，具体意思不详，照这样写就可以了（与服务发现有关）

      j->disco()->setVersion( "messageTest", GLOOX_VERSION, "Linux" );              

      j->disco()->setIdentity( "client", "bot" );

       //关于数字证书认证方面的东东，照抄就行了。

      StringList ca;

      ca.push_back( "/path/to/cacert.crt" );

      j->setCACerts( ca );

      //调用j->connect(false)时，即实现与服务器的连接，即登陆了，连接成功会返回//为真。Connect函数参数为false表示不阻塞方式连接，而如果为真，则为阻塞//方式连接

      if( j->connect( false ) )

      {       

      }     

    }

    //该该方法即为实现ConnectionListener监听器接口中的连接成功的方法实现。

    virtual void onConnect()

    {

      printf( "连接服务器成功!!!/n" );

    }

//该该方法即为实现ConnectionListener监听器接口中的连接失败或者

//断开网络的方法实现。

    virtual void onDisconnect( ConnectionError e )

    {

      printf( "断开连接: %d/n", e );

       delete( j );        

    }

       ///该该方法即为实现ConnectionListener监听器接口中的安全连接成功的方法实现。

    virtual bool onTLSConnect( const CertInfo& info )

    {    

      return true;

    }

private:

    Client *j;//客户端实例对象   

};

int main( int , char** )//测试代码

{

MessageTest *r = new MessageTest();

r->start();

delete( r );

return 0;

}

在连接服务器中，只要你创建了一个Client对象实例，你就可以通过该实例操作了。其实获得一个与服务器的连接，就是获得一个Client实例对象，只要获得这个实例对象，就拥有了和服务器的连接（前提是调用了Client对象中的connect()该方法）。

另外还需要注意的是，gloox内部在连接服务器时，如果在约5分钟内，没有和服务器互通消息的话，会自动断开连接的，故需要做一个定时器，在小于5分钟的时候，向服务器发一个消息，具体的消息一般可以用在线状态这种类型的消息。我做的时候，是通过一个定时，然后先获得在席状态，然后再把这个原原本本的再设置一次就可以了，代码是这样的：

Presence pre = client->presence();//client为创建的那个客户端对象

client ->setPresence(pre);