org.jivesoftware.smack

Interface StanzaListener

All Known Subinterfaces:

PacketListener

All Known Implementing Classes:

SmackFuture.InternalProcessStanzaSmackFuture, SmackFuture.SimpleInternalProcessStanzaSmackFuture

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 is found, the processStanza(Stanza) method will be called. This is the opposite approach to the functionality provided by a StanzaCollector 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.addStanzaInterceptor(StanzaListener, org.jivesoftware.smack.filter.StanzaFilter)

See Also:

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

Method Summary

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

Method Detail

processStanza

void processStanza(Stanza packet)
            throws SmackException.NotConnectedException,
                   java.lang.InterruptedException,
                   SmackException.NotLoggedInException

Process the next stanza sent to this stanza listener.

If this listener is synchronous, then 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 to process.

Throws:

SmackException.NotConnectedException

java.lang.InterruptedException

SmackException.NotLoggedInException