Smack:入门

这个文档将会想你介绍Smack API，并为重要的类和概念提供一个概览。 

JAR文件和要求 

Smack很容易嵌入到任何存在的JDK1.5或者更高版本的Java应用程序。它没有外部依赖（除了Jingle语音聊天功能）并且尽可能优化的更小。这个库有几个JAR文件，基于应用程序需要哪些特性灵活的提供： 

• smack.jar--提供核心XMPP功能，并且是唯一被要求的库。所有XMPP RFC包含的XMPP功能。 

• smackx.jar--支持XMPP标准基金会定义的许多扩展（XEPs），包含多用户聊天，文件传输，用户搜索，等。这个扩展在extensions manual中被记录。 

• smackx-debug.jar--一个增强的图形协议传输调试器。当在classpath被找到并且当启动debugging的时候它将自动使用。 

建立一个连接 

XMPPConnection类被用于简历一个和XMPP服务器的连接。下面的代码示例简历了一个连接： 

// Create a connection to the jabber.org server. Connection conn1 = new XMPPConnection("jabber.org"); conn1.connect();  
// Create a connection to the jabber.org server on a specific port.  
ConnectionConfiguration config = new ConnectionConfiguration("jabber.org", 5222); Connection conn2 = new XMPPConnection(config); conn2.connect(); 

一旦你创建了一个连接，你应该使用Connection.login(String username,String password)方法用用户名和密码登陆。一旦你登陆了，你可以通过创建一个新的Char或者GroupChat对象和其它用户聊天。 

处理名单 

名单让你跟踪其它用户的可用性（存在）。用户能被分组，例如"Friends"和"Co-workers"，并且然后你发现是否每个用户在线或者不在线。 

使用Connection.getRoster()方法获取名单。Roster类允许你找到所有名单实体，它们属于的群组，和每个实体的当前存在状态。 

读和写Packet 

每个从客户端发送给XMPP服务器的消息被称为packet，并且以XML发送。org.jivesoftware.smack.packet包包含封装XMPP支持的三个不同基本paket类型（message，presence，和IQ）的类。例如Chat类和GroupChat类提供了更高级的构造，自动管理创建和发送packet，但是你也能直接创建和发送packet。下面是一个代码示例用改变你的存在，让人们知道你不可用并且”下线“： 

// Create a new presence. Pass in false to indicate we're unavailable. 
Presence presence = new Presence(Presence.Type.unavailable); 
presence.setStatus("Gone fishing");  
// Send the packet (assume we have a Connection instance called "con"). 
con.sendPacket(presence);