org.jivesoftware.smack

Interface PacketListener

public interface PacketListener

Provides a mechanism to listen for packets that pass a specified filter. This allows event-style programming -- every time a new packet is found, the processPacket(Stanza) method will be called. This is the opposite approach to the functionality provided by a PacketCollector which lets you block while waiting for results.

Additionally you are able to intercept Packets that are going to be send and make modifications to them. You can register a PacketListener as interceptor by using XMPPConnection.addPacketInterceptor(PacketListener, org.jivesoftware.smack.filter.PacketFilter)

See Also:

XMPPConnection.addAsyncPacketListener(PacketListener, org.jivesoftware.smack.filter.PacketFilter)

Method Summary

Methods

Modifier and Type	Method and Description
void	processPacket(Stanza packet) Process the next packet sent to this packet listener.

Method Detail

processPacket

void processPacket(Stanza packet)
                   throws SmackException.NotConnectedException

Process the next packet sent to this packet listener.

A single thread is responsible for invoking all listeners, so it's very important that implementations of this method not block for any extended period of time.

Parameters:

packet - the packet to process.

Throws:

SmackException.NotConnectedException