org.jivesoftware.smack

Interface StanzaListener

All Known Subinterfaces:

PacketListener

All Known Implementing Classes:

Node.ItemDeleteTranslator, Node.ItemEventTranslator, Node.NodeConfigTranslator

public interface StanzaListener

Provides a mechanism to listen for packets that pass a specified filter. This allows event-style programming -- every time a new stanza(/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(StanzaListener, org.jivesoftware.smack.filter.StanzaFilter)

Author:

Matt Tucker

See Also:

XMPPConnection.addAsyncStanzaListener(StanzaListener, org.jivesoftware.smack.filter.StanzaFilter)

Method Summary

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

Method Detail

processPacket

void processPacket(Stanza packet)
            throws SmackException.NotConnectedException

Process the next stanza(/packet) sent to this stanza(/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 stanza(/packet) to process.

Throws:

SmackException.NotConnectedException