XMPP客户端库Smack 4.1.4版官方开发文档之二

本文转载自：博客主页：http://blog.csdn.net/chszs

三、Smack库的组成
Smack库可以内嵌到任意的Java应用程序中。Smack库有数个JAR文件组成，非常具有灵活性。
1、smack-core.jar
提供了核心XMPP功能。都是XMPP RFC规范定义的XMPP特性。
2、smack-extensions.jar
支持许多由XMPP Standards Foundation定义的扩展（XEP）功能。包括群聊、文件传输、用户搜索等等。
以后可查看文档《扩展手册》：
https://github.com/igniterealtime/Smack/blob/master/documentation/extensions/index.html
（目前还是无效的）
3、smack-experimental.jar
支持许多由XMPP Standards Foundation定义的体验性（XEP）功能。其API和功能特性都被认为是不稳定的。
4、smack-legacy.jar
支持许多由XMPP Standards Foundation定义的遗留（XEP）功能。
5、smack-bosh.jar
支持BOSH通信（XEP-0124规范定义的）。此代码被认为处于Beta阶段。
6、smack-jingle.jar
支持Jingle。此代码很老，目前处于无维护的状态。
7、smack-resolver-dnsjava.jar
支持对DNS SRV记录的解析，主要用于那些不支持javax.naming API的平台。
8、smack-debug.jar
用于协议流量的增强型GUI调试器。当调试模式开启后，如果它在类路径下，它会自动被使用。
以后可查看文档《调试模式》：
https://github.com/igniterealtime/Smack/blob/master/documentation/debugging.html
（目前还是无效的）

四、Smack的配置
Smack的初始化过程涉及到2阶段的调用。
1、初始化系统属性
通过SmackConfiguration类初始化所有的系统可访问属性，这些属性都是通过getXXX方法取回属性值的。
2、初始化启动类
任意类如果继承了SmackInitializer接口后，都可以在调用initialize()方法后得到初始化，这意味着得到初始化的类在启动后都是活动的。
如果没有继承SmackInitializer接口，那么要实现初始化，必须要放置一个静态代码块来实现——他在类装载时会自动执行。

初始化是通过配置文件来完成的。默认情况下，Smack会载入Smack JAR文件中内嵌的配置文件（它位于org.jivesoftware.smack/smack-config.xml）。这个指定的配置文件包含了一系列需载入初始化的类列表。所有的管理器类型的类都需要被初始化，这些管理器类就包含在上面所说的初始化列表中。

五、建立连接的例子

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

第一种连接方式：

	boolean target = false;
		AbstractXMPPConnection conn = new XMPPTCPConnection(username, password, serverName);
		try {
			conn.connect();
			target = conn.isConnected();
			if(target){
				System.out.println("XMPP 服务器连接成功");
			}else{
				System.out.println("XMPP 服务器连接不成功");
			}
		} catch (SmackException | IOException | XMPPException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}

第二种连接方式：

boolean target=false;
		XMPPTCPConnectionConfiguration config = XMPPTCPConnectionConfiguration.builder()
				  .setUsernameAndPassword(username, password)
				  .setServiceName(serverName)
				  .setHost(serverName)
				  .setPort(5222)
				  .build();
		AbstractXMPPConnection conn = new XMPPTCPConnection(config);
		try {
			conn.connect();
			target = conn.isConnected();
			if(target){
				System.out.println("XMPP 服务器连接成功");
			}else{
				System.out.println("XMPP 服务器连接不成功");
			}
		} catch (SmackException | IOException | XMPPException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}

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

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

七、Roster（联系人状态）的用法【之前转载的博主把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");
//
con.sendStanza(presence);

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