XMPP客户端库Smack 4.0.6版开发之二

XMPP客户端库Smack 4.0.6版开发之二

六、建立连接的例子

XMPPConnection类用于创建一个到XMPP服务器的连接，代码例子如下：

// 创建一个到jabber.org服务器的连接
AbstractXMPPConnection conn1 = new XMPPTCPConnection("username", "password", "jabber.org");
conn1.connect();

// 创建一个到jabber.org服务器指定端口的连接
XMPPTCPConnectionConfiguration config = XMPPTCPConnectionConfiguration.builder()
		.setUsernameAndPassword("username", "password")
		.setServiceName("jabber.org")
		.setHost("earl.jabber.org")
		.setPort("8222)
		.build();
AbstractXMPPConnection conn2 = new XMPPTCPConnection(config);
conn2.connect();

注意，在连接到XMPP服务器时，如果采用默认设置，会使用最大程度的安全，包括TLS加密的应用。ConnectionConfiguration类通过了对创建的连接的高级控制，比如可以开启或关闭加密。
以后可查看文档《XMPPConnection Management》：
https://github.com/igniterealtime/Smack/blob/master/documentation/connections.html
（目前还是无效的）

一旦你创建了一个连接后，你应该调用XMPPConnection.login()方法进行服务器登录。一旦登录后，你就可以通过创建Chat对象或GroupChat对象开始与其他用户聊天了。

七、Roster（名单）的用法

Roster用于跟踪其他用户是否在线。用户的联系人可以以分组的方式进行组织，比如“好友”、“同事”。然后就可以查看组中的每个用户是否在线了。

要检索Roster，使用XMPPConnection.getRoster()方法。Roster类允许你查找所有的Roster实体，以及他们属于哪个组，每个实体当前的在线状态。

八、读写Packet（数据包）

从客户端发送到XMPP服务器的每一条消息都称为一个Packet（数据包）。org.jivesoftware.smack.packet库中包含了XMPP支持的（消息Message、在线状态Presence、IQ）三种不同的基本数据包类型的封装类。而像Chat或GroupChat这样的类则提供了更高层的结构来管理数据包的自动创建和发送。但是，开发者还是可以直接创建和发送数据包的。
下面的代码就是修改自己的在线状态，让其他人知道你不在线。

// 创建新在线状态对象，并设为离线状态
Presence presence = new Presence(Presence.Type.unavailable);
presence.setStatus("Gone fishing");
// 发送数据包（假设我们已经有XMPPConnection的连接实例con
con.sendPacket(presence);

Smack提供了两种读取到来的数据包的方式：PacketListener（包监听器）和PacketCollector（包收集器）。
两者都使用PacketFilter实例来判断应该处理哪一个数据包。
PacketListener（包监听器）用于事件风格的编程，而PacketCollector（包收集器）有一个数据包的结果队列，你可以做轮询或阻塞等操作。
也就是说，如果你想在数据包到来时执行一些动作，那么包监听器很适合。如果你想等待指定的数据包的到来，那么包收集器很适合。
包收集器和包监听器都使用Connection连接实例创建。