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

一、处理出入的字节

smacke 类库 提供了处理传入的字节，主要依靠两个类：org.jivesoftware.smack.PacketCollector 和 org.jivesoftware.smack.PacketListener

org.jivesoftware.smack.PacketCollector：该类提供synchronously（同步）方法，等待接受数据包（Packets）.

org.jivesoftware.smack.PacketListener: 该接口提供asynchronously（异步）方法，等待结束数据包（Packets）。

数据包侦听器是被用于事件风格编程，当一个数据包集合拥有数据包队列，你可以对数据包集合进行轮训和阻塞操作。

当你想特定的数据包进入时，会触发某些特定行动，你可以实现数据包侦听器接口，来实现你想要的功能。

数据包集合也是同理，但特定的数据包进入数据包集合，也会触发某些特定行动，你可以实现数据包集合类，来实现你想要的功能。

数据包集合（PacketCollector）和数据包接口（PacketListener）是通过XMPPConnection 实例对象创建。

org.jivesoftware.smack.filter.StanzaFilter接口可以决定,那些特定的数据包会被传递到PacketCollector 或者PacketListener。

许多预先定义的拦截器都实现了org.jivesoftware.smack.filter接口。

下面的代码片段，演示了注册的数据包监听器和数据包集合

// Create a packet filter to listen for new messages from a particular
// user. We use an AndFilter to combine two other filters._
StanzaFilter filter = new AndFilter(new StanzaTypeFilter(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);

标准段落（字符）拦截器

smack 类库中已经包含很多包拦截器，你也可以创建属于自己的拦截器，

只需要代码实现StanzaFilter接口，默认的拦截器包含如下：

• StanzaTypeFilter --特定类型的数据包过滤器
• StanzaIdFilter -- 特定数据包标识筛选器
• ThreadFilter -- 特定线程标识数据包过滤器
• ToContainsFilter -- 特定发送地址数据包过滤器
• FromContainsFilter -- 特定接受地址数据包过滤器.
• StanzaExtensionFilter -- 特定包扩展数据包过滤器
• AndFilter -- implements the logical AND operation over two filters.
• OrFilter -- implements the logical OR operation over two filters.
• NotFilter -- implements the logical NOT operation on a filter.