- All Known Subinterfaces:
- All Known Implementing Classes:
public interface StanzaListenerProvides 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
StanzaCollectorwhich 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
All Methods Instance Methods Abstract Methods Modifier and Type Method Description
processStanza(Stanza packet)Process the next stanza sent to this stanza listener.
void processStanza(Stanza packet) throws SmackException.NotConnectedException, InterruptedException, SmackException.NotLoggedInExceptionProcess 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.
packet- the stanza to process.
SmackException.NotConnectedException- if the XMPP connection is not connected.
InterruptedException- if the calling thread was interrupted.
SmackException.NotLoggedInException- if the XMPP connection is not authenticated.