XMPPConnection connection = new XMPPConnection("jabber.org");

connection.login("mtucker", "password");

connection.createChat("jsmith@jivesoftware.com").sendMessage("Howdy!;

// 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 XMPPConnection instance called "con").

con.sendPacket(presence);

// Assume we've created an XMPPConnection name "connection".

Chat newChat = connection.createChat("jsmith@jivesoftware.com");

newChat.sendMessage("Howdy!");

// Assume we've created an XMPPConnection name "connection".

Chat newChat = connection.createChat("jsmith@jivesoftware.com");

Message newMessage = newChat.createMessage();

newMessage.setBody("Howdy!");

message.setProperty("favoriteColor", "red");

newChat.sendMessage(newMessage);

// Assume we've created an XMPPConnection name "connection".

Chat newChat = connection.createChat("jsmith@jivesoftware.com");

newMessage.setBody("Hi, I'm an annoying parrot-bot! Type something back to me.");

while (true) {

    // Wait for the next message the user types to us.

    Message message = newChat.nextMessage();

    // Send back the same text the other user sent us.

    newChat.sendMessage(message.getBody());

}

// Assume we've created an XMPPConnection name "connection".

GroupChat newGroupChat = connection.createGroupChat("test@jivesoftware.com");

// Join the group chat using the nickname "jsmith".

newGroupChat.join("jsmith");

// Send a message to all the other people in the chat room.

newGroupChat.sendMessage("Howdy!");

Roster roster = con.getRoster();

for (Iterator i=roster.getEntries(); i.hasNext(); ) {

    System.out.println(i.next());

}

final Roster roster = con.getRoster();

roster.addRosterListener(new RosterListener() {

    public void rosterModified() {

        // Ignore event for this example.

    }

    public void presenceChanged(String user) {

        // If the presence is unavailable then "null" will be printed,

        // which is fine for this example.

        System.out.println("Presence changed: " + roster.getPresence(user));

    }

});

• org.jivesoftware.smack.PacketCollector – 一个允许你同步的等待新的信息包的类
• org.jivesoftware.smack.PacketListener – 一个异步的通知你收到信息包的接口

信息包监听器（packet listener）用于事件类型的设计，而信息包收集器（packet collector）有一个信息包的结果队列，你可以对其实施polling和blocking操作。所以，信息包监听器在你收到任何一个信息包，且你想对其进行操作时是有用的，而信息包收集器在你想等待某个特殊的信息包时是有用的。信息包收集器和监听器可以通过XMPPConnection的实例来创建。

由org.jivesoftware.smack.filter.PacketFilter接口来决定哪个特殊的信息包将被转交给信息包收集器（PacketCollector）或信息包监听器（PacketListener）。可以在org.jivesoftware.smack.filter包中找到许多预先定义的过滤器。

以下代码阐释了如何注册一个信息包收集器（packet collector）和信息包监听器（packet listener）：

// Create a packet filter to listen for new messages from a particular

// user. We use an AndFilter to combine two other filters.

PacketFilter filter = new AndFilter(new PacketTypeFilter(Message.class),

        new FromContainsFilter("mary@jivesoftware.com"));

// Assume we've created an XMPPConnection name "connection".

// First, register a packet collector using the filter we created.

PacketCollector myCollector = connection.createPacketCollector(filter);

// Normally, you'd do something with the collector, like wait for new packets.

// Next, create a packet listener. We use an anonymous inner class for brevity.

PacketListener myListener = new PacketListener() {

        public void processPacket(Packet packet) {

            // Do something with the incoming packet here.

        }

    };

// Register the listener.

connection.addPacketListener(myListener, filter);

标准信息包过滤器（Standard Packet Filters）

Smack包含一套丰富的信息包过滤器，你也可以通过信息包过滤器接口（PacketFilter interface）编写程序来创建自己的过滤器。缺省的过滤器集包括：

• PacketTypeFilter – 某个特殊的类类型的信息包过滤器
• PacketIDFilter – 拥有特殊的信息包ID（packet ID）的过滤器
• ThreadFilter – 拥有特殊线程ID（thread ID）的信息包的过滤器
• ToContainsFilter –发送到某个特殊地址的信息包的过滤器
• FromContainsFilter --发送到某个特殊地址的信息包的过滤器
• PacketExtensionFilter – 拥有特殊的信息包扩展的信息包的过滤器
• AndFilter –对两个过滤器实施逻辑与操作的过滤器
• OrFilter --对两个过滤器实施逻辑或操作的过滤器
• NotFilter --对一个过滤器实施逻辑非操作的过滤器

Provider Architecture: Packet Extensions and Custom IQ's

Smack提供的体系是堵塞自定义的XML信息包扩展和IQ包分析器的系统（The Smack provider architecture is a system for plugging in custom XML parsing of packet extensions and IQ packets）。标准的Smack扩展（Smack Extensions）是使用提供者的体系结构搭建的。存在以下两种类型的提供者：

• IQProvider –将IQ请求（ IQ requests）解析成Java对象（Java objects）
• PacketExtension – 将附属在信息包上的XML子文档解析成信息包扩展实例（PacketExtension instances）

IQProvider

默认情况下，Smack致知道如何处理只有类似以下几个名字空间的子信息包的IQ信息包（IQ packets）：

• jabber:iq:auth
• jabber:iq:roster
• jabber:iq:register

因为许多IQ类型是XMPP及其扩展部分的一部分，所以提供一个可插入的IQ分析机制。IQ Providers被程序自动的注册或通过创建在你的JAR 文件的META-INF目录下创建一个mack.providers文件。该文件是一个包含一个或多个iqProvider条目（iqProvider entries）的XML文档，如下例所示：

<?xml version="1.0"?>

 <smackProviders>

     <iqProvider>

         <elementName>query</elementName>

         <namespace>jabber:iq:time</namespace>

         <className>org.jivesoftware.smack.packet.Time</className>

     </iqProvider>

 </smackProviders>

每一个IQ provider都和一个元素名（element name）和名字空间（ namespace）相联系。在上面的例子中，元素名是query，名字空间是abber:iq:time。如果有多重提供者条目（multiple provider entries）尝试注册并控制相同的名字空间，那么从类路径（classpath）载入的第一个条目将有优先权。

IQ provider类可以实现IQProvide接口，或者继承IQ类。在前面的例子中，每一个IQProvider负责解析原始的XML流从而创建一个IQ实例。在下面的例子中，bean introspection将被用于尝试自动使用在IQ packet XML中发现的值设置IQ实例的属性。一个XMPP时间信息包如下所示：

<iq type='result' to='joe@example.com' from='mary@example.com' id='time_1'>

    <query xmlns='jabber:iq:time'>

        <utc>20020910T17:58:35</utc>

        <tz>MDT</tz>

        <display>Tue Sep 10 12:58:35 2002</display>

    </query>

</iq>

为了让这个信息包自动的映射成上面的providers file中所列的时间对象（Time object），它必须有以下几个方法：setUtc(String), setTz(String), 和 setDisplay(String)。自动检查（introspection）的服务将试着自动的将字符串值转化成a boolean, int, long, float, double,或 Class 类型。转化成何种类型由IQ实例的需要来决定。

PacketExtensionProvider

信息包插件提供者（Packet extension providers）为信息包提供一个可插入的系统，这些信息包是一个IQ, message和presence packets的自定义名字空间的子元素。每一个插件提供者（extension provider）使用一个元素名（element name）和名字空间（namespace）在smack.providers文件中注册，如下例所示：

<?xml version="1.0"?>

<smackProviders>

    <extensionProvider>

        <elementName>x</elementName>

        <namespace>jabber:iq:event</namespace>

        <className>org.jivesoftware.smack.packet.MessageEvent</className>

    </extensionProvider>

</smackProviders>

如果有多重提供者条目（multiple provider entries）尝试注册并控制相同的名字空间，那么从类路径（classpath）载入的第一个条目将有优先权。

一旦在一个信息包中发现信息包插件，解析器将传递到正确的提供者。每一个提供者可以实现PacketExtensionProvider接口或者是一个标准的Java Bean。在前面的例子中，每一个插件提供者（extension provider）负责解析原始的XML流去构造一个实例。在下面的例子中，bean introspection将被用于尝试自动使用在信息包插件子元素（packet extension sub-element）中的值设置类的属性。

当一个插件提供者（extension provider）没有用元素名（element name）和名字空间（namespace）对注册是，Smack将存储所有在缺省信息包插件（DefaultPacketExtension）对象中的*别元素（top-level elements），并匹配到信息包上。

信息包属性（Packet Properties）

Smack提供简单的机制来将任意的属性附加到信息包上。每一个属性有个字符串类型的名字和一个值，这个值或者是Java原始数据类型（int, long, float, double, boolean）的，或者是任何可序列化的对象（Serializable object）（当一个java对象实现了Serializable接口时，它就是可序列化的）。

使用API（Using the API）

所有主要对象都有属性支持，例如消息对象（Message objects）。以下代码阐释了如何设置属性：

Message message = chat.createMessage();

// Add a Color object as a property.

message.setProperty("favoriteColor", new Color(0, 0, 255));

// Add an int as a property.

message.setProperty("favoriteNumber", 4);

chat.sendMessage(message);

获得这些相同的属性要用到以下的代码：

Message message = chat.nextMessage();

// Get a Color object property.

Color favoriteColor = (Color)message.getProperty("favoriteColor");

// Get an int property. Note that properties are always returned as

// Objects, so we must cast the value to an Integer, then convert

// it to an int.

int favoriteNumber = ((Integer)message.getProperty("favoriteNumber")).intValue();

将对象作为属性（Objects as Properties）

将对象作为属性值是改变数据的一个非常有力和简单的方法。但是，你应该记住以下几点：

l           信息包插件（Packet extensions）是向XMPP增加额外数据的更权威的方式。使用属性在某种情况下也许会比较方便，但是，Smack将会控制XML。

l           当你将Java对象（Java object）作为属性发送时，只有在客户机运行的Java能够解释数据。所以，可以考虑使用一系列的原始值来传递数据。

l           作为属性值发送的对象必须实现序列化接口（Serialiable）。除此之外，发送者和接受者都必须由相同版本的类，否则在反序列化（de-serializing the object）对象时将发生序列化异常。

l           序列化的对象将会非常大，将会占用很多的服务器资源和带宽。

XML格式（XML Format）

当前的用于发送属性的XML格式不是标准的，所以可能不会得到使用Smack的客户的认可。XML如下所示（为了更清晰添加了注释）：

<!-- All properties are in a x block. -->

<properties xmlns="http://www.jivesoftware.com/xmlns/xmpp/properties">

    <!-- First, a property named "prop1" that's an integer. -->

    <property>

        <name>prop1</name>

        <value type="integer">123</value>

    <property>

    <!-- Next, a Java object that's been serialized and then converted

         from binary data to base-64 encoded text. --> 

    <property>

        <name>blah2</name>

        <value type="java-object">adf612fna9nab</value>

    <property>

</properties>

当前支持的数据类型有：integer, long, float, double, boolean, string, 和java-object。

使用Smack调试（Debugging with Smack）

Smack包含两个内置的调试控制台，他们允许你在服务器和客户机建跟踪XML的踪迹。简单的调试器（lite debugger）是smack.jar的一部分，加强的调试器（enhanced debugger）包含在（smackx-debug.jar）中。

可以用两种不同的方法激活调试模式：

1．             在创建连接前加入以下一行代码：

XMPPConnection.DEBUG_ENABLED = true;

2．             将Java的系统属性smack.debugEnabled设置为true。这一系统属性可通过下一命令行设置：

java -Dsmack.debugEnabled=true SomeApp

在你的应用程序中，如果你想明确的禁用调试模式，包括使用命令行参数，则在打开新的连接前在你的应用程序中添加以下一行代码：

XMPPConnection.DEBUG_ENABLED = false;

Smack使用一下的逻辑来决定使用哪个调制控制台：

1. 它将首先尝试使用Java系统属性smack.debuggerClass 所指定的调试类（debugger class）。如果你需要开发自己的调试器 I，可以实现SmackDebugger 接口然后使用下面的命令行设置系统属性：

java -Dsmack.debuggerClass=my.company.com.MyDebugger SomeApp

1. 如果第一步失败了，Smack就会尝试使用增强的调试器（enhanced debugger）。 文件 smackx-debug.jar 包含，因此你要把jar文件放到类路径（classpath）下。如果空间确定你只是想要配置smack.jar文件，这种情况下增强的调试器（enhanced debugger）将不可用。
2. 最后一种是前面两种都失败后使用简单的调试器（ite debugger）。在你的内存很小的时候，简单的调试器（ite debugger）是一个很好的选择。

增强的调试器（enhanced debugger）

当调试模式可用时，将出现一个包含每一个创建的连接的标签调试窗口，该窗口包含以下信息：

• 连接标签（Connection tabs） -- 每一个标签显示连接相关的调试信息
• Smack信息标签（Smack info tab） -- 显示关于Smack的信息 (例如： Smack的版本（Smack version）, 安装的组件（installed components）,等等)。

连接标签包含以下信息:

• 所有的信息包（All Packets） -- 显示由Smack解析的发送和收到的信息包的信息。
• 未经处理的发送信息包（Raw Sent Packets） -- 未经处理的XML traffic（raw XML traffic）由Smack生成并发送至服务器 。
• 未经处理的接收信息包（Raw Received Packets） --未经处理的XML traffic（raw XML traffic）由服务器发送给客户机。
• Ad-hoc 消息（Ad-hoc message） -- 允许发送各种类型的ad-hoc信息包（ad-hoc packets）。
• 信息—显示连接状态和统计信息。

简单的调试器（Lite Debugger ）

当调试模式可用时，每创建一个连接将出现调试窗口，该窗口包含以下信息：

• 客户端的流量（Client Traffic） (红色的文本) --未经处理的XML traffic（raw XML traffic）由Smack生成并发送至服务器 。
• 服务器端的流量（Server Traffic）(蓝色的文本) --未经处理的XML traffic（raw XML traffic）由服务器发送给客户机。
• 解释的信息包（Interpreted Packets）(绿色的文本) – 显示来自服务器的由Smack解析的XML信息包（XML packets）

右击任何面板会出现一个菜单，上面有一个选项可以将这些内容拷贝到系统的剪贴板或者清除面板中的内容。

http://blog.sina.com.cn/s/blog_54ef39890100ueq4.html