org.jivesoftware.smack

Interface XMPPConnection

All Known Implementing Classes:

AbstractXMPPConnection, XMPPBOSHConnection, XMPPTCPConnection

public interface XMPPConnection

The XMPPConnection interface provides an interface for connections to an XMPP server and implements shared methods which are used by the different types of connections (e.g. XMPPTCPConnection or XMPPBOSHConnection). To create a connection to an XMPP server a simple usage of this API might look like the following:

 // Create a connection to the igniterealtime.org XMPP server.
 XMPPTCPConnection con = new XMPPTCPConnection("igniterealtime.org");
 // Connect to the server
 con.connect();
 // Most servers require you to login before performing other tasks.
 con.login("jsmith", "mypass");
 // Start a new conversation with John Doe and send him a message.
 Chat chat = ChatManager.getInstanceFor(con).createChat("jdoe@igniterealtime.org", new MessageListener() {
     public void processMessage(Chat chat, Message message) {
         // Print out any messages we get back to standard out.
         System.out.println("Received message: " + message);
     }
 });
 chat.sendMessage("Howdy!");
 // Disconnect from the server
 con.disconnect();
 

Note that the XMPPConnection interface does intentionally not declare any methods that manipulate the connection state, e.g. connect(), disconnect(). You should use the most specific connection type, e.g. XMPPTCPConnection as declared type and use the XMPPConnection interface when you don't need to manipulate the connection state.

XMPPConnections can be reused between connections. This means that an Connection may be connected, disconnected and then connected again. Listeners of the XMPPConnection will be retained across connections.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	XMPPConnection.FromMode

Method Summary

Methods

Modifier and Type	Method and Description
void	addAsyncStanzaListener(StanzaListener packetListener, StanzaFilter packetFilter) Registers an asynchronous stanza(/packet) listener with this connection.
void	addConnectionListener(ConnectionListener connectionListener) Adds a connection listener to this connection that will be notified when the connection closes or fails.
void	addOneTimeSyncCallback(StanzaListener callback, StanzaFilter packetFilter) Add a callback that is called exactly once and synchronously with the incoming stanza that matches the given stanza(/packet) filter.
void	addPacketInterceptor(StanzaListener packetInterceptor, StanzaFilter packetFilter) Registers a stanza(/packet) interceptor with this connection.
void	addPacketListener(StanzaListener packetListener, StanzaFilter packetFilter) Deprecated. use addAsyncStanzaListener(StanzaListener, StanzaFilter) or addSyncStanzaListener(StanzaListener, StanzaFilter).
void	addPacketSendingListener(StanzaListener packetListener, StanzaFilter packetFilter) Registers a stanza(/packet) listener with this connection.
void	addSyncStanzaListener(StanzaListener packetListener, StanzaFilter packetFilter) Registers a synchronous stanza(/packet) listener with this connection.
PacketCollector	createPacketCollector(PacketCollector.Configuration configuration) Create a new stanza(/packet) collector with the given stanza(/packet) collector configuration.
PacketCollector	createPacketCollector(StanzaFilter packetFilter) Creates a new stanza(/packet) collector for this connection.
PacketCollector	createPacketCollectorAndSend(IQ packet) Creates a new stanza(/packet) collector collecting packets that are replies to packet.
PacketCollector	createPacketCollectorAndSend(StanzaFilter packetFilter, Stanza packet) Creates a new stanza(/packet) collector for this connection.
int	getConnectionCounter() Get the connection counter of this XMPPConnection instance.
<F extends ExtensionElement> F	getFeature(String element, String namespace) Get the feature stanza(/packet) extensions for a given stream feature of the server, or null if the server doesn't support that feature.
XMPPConnection.FromMode	getFromMode() Get the currently active FromMode.
String	getHost() Returns the host name of the server where the XMPP server is running.
long	getLastStanzaReceived() Returns the timestamp in milliseconds when the last stanza was received.
long	getPacketReplyTimeout() Returns the current value of the reply timeout in milliseconds for request for this XMPPConnection instance.
int	getPort() Returns the port number of the XMPP server for this connection.
String	getServiceName() Returns the name of the service provided by the XMPP server for this connection.
String	getStreamId() Returns the stream ID for this connection, which is the value set by the server when opening an XMPP stream.
String	getUser() Returns the full XMPP address of the user that is logged in to the connection or null if not logged in yet.
boolean	hasFeature(String element, String namespace) Return true if the server supports the given stream feature.
boolean	isAnonymous() Returns true if currently authenticated anonymously.
boolean	isAuthenticated() Returns true if currently authenticated by successfully calling the login method.
boolean	isConnected() Returns true if currently connected to the XMPP server.
boolean	isSecureConnection() Returns true if the connection to the server has successfully negotiated encryption.
boolean	isUsingCompression() Returns true if network traffic is being compressed.
IQRequestHandler	registerIQRequestHandler(IQRequestHandler iqRequestHandler) Register an IQ request handler with this connection.
boolean	removeAsyncStanzaListener(StanzaListener packetListener) Removes an asynchronous stanza(/packet) listener for received packets from this connection.
void	removeConnectionListener(ConnectionListener connectionListener) Removes a connection listener from this connection.
void	removePacketCollector(PacketCollector collector) Remove a stanza(/packet) collector of this connection.
void	removePacketInterceptor(StanzaListener packetInterceptor) Removes a stanza(/packet) interceptor.
boolean	removePacketListener(StanzaListener packetListener) Deprecated. use removeAsyncStanzaListener(StanzaListener) or removeSyncStanzaListener(StanzaListener).
void	removePacketSendingListener(StanzaListener packetListener) Removes a stanza(/packet) listener for sending packets from this connection.
boolean	removeSyncStanzaListener(StanzaListener packetListener) Removes a stanza(/packet) listener for received packets from this connection.
void	send(PlainStreamElement element) Send a PlainStreamElement.
void	sendIqWithResponseCallback(IQ iqRequest, StanzaListener callback) Send a IQ stanza and invoke callback if there is a result of IQ.Type.result with that result IQ.
void	sendIqWithResponseCallback(IQ iqRequest, StanzaListener callback, ExceptionCallback exceptionCallback) Send a IQ stanza and invoke callback if there is a result of IQ.Type.result with that result IQ.
void	sendIqWithResponseCallback(IQ iqRequest, StanzaListener callback, ExceptionCallback exceptionCallback, long timeout) Send a IQ stanza and invoke callback if there is a result of IQ.Type.result with that result IQ.
void	sendPacket(Stanza packet) Deprecated. use sendStanza(Stanza) instead.
void	sendStanza(Stanza stanza) Sends the specified stanza to the server.
void	sendStanzaWithResponseCallback(Stanza stanza, StanzaFilter replyFilter, StanzaListener callback) Send a stanza and wait asynchronously for a response by using replyFilter.
void	sendStanzaWithResponseCallback(Stanza stanza, StanzaFilter replyFilter, StanzaListener callback, ExceptionCallback exceptionCallback) Send a stanza and wait asynchronously for a response by using replyFilter.
void	sendStanzaWithResponseCallback(Stanza stanza, StanzaFilter replyFilter, StanzaListener callback, ExceptionCallback exceptionCallback, long timeout) Send a stanza and wait asynchronously for a response by using replyFilter.
void	setFromMode(XMPPConnection.FromMode fromMode) Set the FromMode for this connection instance.
void	setPacketReplyTimeout(long timeout) Set the stanza(/packet) reply timeout in milliseconds.
IQRequestHandler	unregisterIQRequestHandler(IQRequestHandler iqRequestHandler) Convenience method for unregisterIQRequestHandler(String, String, org.jivesoftware.smack.packet.IQ.Type).
IQRequestHandler	unregisterIQRequestHandler(String element, String namespace, IQ.Type type) Unregister an IQ request handler with this connection.

Method Detail

getServiceName

String getServiceName()

Returns the name of the service provided by the XMPP server for this connection. This is also called XMPP domain of the connected server. After authenticating with the server the returned value may be different.

Returns:

the name of the service provided by the XMPP server.

getHost

String getHost()

Returns the host name of the server where the XMPP server is running. This would be the IP address of the server or a name that may be resolved by a DNS server.

Returns:

the host name of the server where the XMPP server is running or null if not yet connected.

getPort

int getPort()

Returns the port number of the XMPP server for this connection. The default port for normal connections is 5222.

Returns:

the port number of the XMPP server or 0 if not yet connected.

getUser

String getUser()

Returns the full XMPP address of the user that is logged in to the connection or null if not logged in yet. An XMPP address is in the form username@server/resource.

Returns:

the full XMPP address of the user logged in.

getStreamId

String getStreamId()

Returns the stream ID for this connection, which is the value set by the server when opening an XMPP stream. This value will be null if not connected to the server.

Returns:

the ID of this connection returned from the XMPP server or null if not connected to the server.

See Also:

RFC 6120 § 4.7.3. id

isConnected

boolean isConnected()

Returns true if currently connected to the XMPP server.

Returns:

true if connected.

isAuthenticated

boolean isAuthenticated()

Returns true if currently authenticated by successfully calling the login method.

Returns:

true if authenticated.

isAnonymous

boolean isAnonymous()

Returns true if currently authenticated anonymously.

Returns:

true if authenticated anonymously.

isSecureConnection

boolean isSecureConnection()

Returns true if the connection to the server has successfully negotiated encryption.

Returns:

true if a secure connection to the server.

isUsingCompression

boolean isUsingCompression()

Returns true if network traffic is being compressed. When using stream compression network traffic can be reduced up to 90%. Therefore, stream compression is ideal when using a slow speed network connection. However, the server will need to use more CPU time in order to un/compress network data so under high load the server performance might be affected.

Returns:

true if network traffic is being compressed.

sendPacket

@Deprecated
void sendPacket(Stanza packet)
                throws SmackException.NotConnectedException

Deprecated. use sendStanza(Stanza) instead.

Sends the specified stanza(/packet) to the server.

Parameters:

packet - the stanza(/packet) to send.

Throws:

SmackException.NotConnectedException

sendStanza

void sendStanza(Stanza stanza)
                throws SmackException.NotConnectedException

Sends the specified stanza to the server.

Parameters:

stanza - the stanza to send.

Throws:

SmackException.NotConnectedException - if the connection is not connected.

send

void send(PlainStreamElement element)
          throws SmackException.NotConnectedException

Send a PlainStreamElement.

This method is not meant for end-user usage! It allows sending plain stream elements, which should not be done by a user manually. Doing so may result in a unstable or unusable connection. Certain Smack APIs use this method to send plain stream elements.

Parameters:

element -

Throws:

SmackException.NotConnectedException

addConnectionListener

void addConnectionListener(ConnectionListener connectionListener)

Adds a connection listener to this connection that will be notified when the connection closes or fails.

Parameters:

connectionListener - a connection listener.

removeConnectionListener

void removeConnectionListener(ConnectionListener connectionListener)

Removes a connection listener from this connection.

Parameters:

connectionListener - a connection listener.

createPacketCollectorAndSend

PacketCollector createPacketCollectorAndSend(IQ packet)
                                             throws SmackException.NotConnectedException

Creates a new stanza(/packet) collector collecting packets that are replies to packet. Does also send packet. The stanza(/packet) filter for the collector is an IQReplyFilter, guaranteeing that stanza(/packet) id and JID in the 'from' address have expected values.

Parameters:

packet - the stanza(/packet) to filter responses from

Returns:

a new stanza(/packet) collector.

Throws:

SmackException.NotConnectedException

createPacketCollectorAndSend

PacketCollector createPacketCollectorAndSend(StanzaFilter packetFilter,
                                           Stanza packet)
                                             throws SmackException.NotConnectedException

Creates a new stanza(/packet) collector for this connection. A stanza(/packet) filter determines which packets will be accumulated by the collector. A PacketCollector is more suitable to use than a StanzaListener when you need to wait for a specific result.

Parameters:

packetFilter - the stanza(/packet) filter to use.

packet - the stanza(/packet) to send right after the collector got created

Returns:

a new stanza(/packet) collector.

Throws:

SmackException.NotConnectedException

createPacketCollector

PacketCollector createPacketCollector(StanzaFilter packetFilter)

Creates a new stanza(/packet) collector for this connection. A stanza(/packet) filter determines which packets will be accumulated by the collector. A PacketCollector is more suitable to use than a StanzaListener when you need to wait for a specific result.

Note: If you send a Stanza(/Packet) right after using this method, then consider using createPacketCollectorAndSend(StanzaFilter, Stanza) instead. Otherwise make sure cancel the PacketCollector in every case, e.g. even if an exception is thrown, or otherwise you may leak the PacketCollector.

Parameters:

packetFilter - the stanza(/packet) filter to use.

Returns:

a new stanza(/packet) collector.

createPacketCollector

PacketCollector createPacketCollector(PacketCollector.Configuration configuration)

Create a new stanza(/packet) collector with the given stanza(/packet) collector configuration.

Please make sure to cancel the collector when it is no longer required. See also createPacketCollector(StanzaFilter).

Parameters:

configuration - the stanza(/packet) collector configuration.

Returns:

a new stanza(/packet) collector.

Since:

4.1

removePacketCollector

void removePacketCollector(PacketCollector collector)

Remove a stanza(/packet) collector of this connection.

Parameters:

collector - a stanza(/packet) collectors which was created for this connection.

addPacketListener

@Deprecated
void addPacketListener(StanzaListener packetListener,
                                StanzaFilter packetFilter)

Deprecated. use addAsyncStanzaListener(StanzaListener, StanzaFilter) or addSyncStanzaListener(StanzaListener, StanzaFilter).

Registers a stanza(/packet) listener with this connection.

This method has been deprecated. It is important to differentiate between using an asynchronous stanza(/packet) listener (preferred where possible) and a synchronous stanza(/packet) lister. Refer addAsyncStanzaListener(StanzaListener, StanzaFilter) and addSyncStanzaListener(StanzaListener, StanzaFilter) for more information.

Parameters:

packetListener - the stanza(/packet) listener to notify of new received packets.

packetFilter - the stanza(/packet) filter to use.

removePacketListener

@Deprecated
boolean removePacketListener(StanzaListener packetListener)

Deprecated. use removeAsyncStanzaListener(StanzaListener) or removeSyncStanzaListener(StanzaListener).

Removes a stanza(/packet) listener for received packets from this connection.

Parameters:

packetListener - the stanza(/packet) listener to remove.

Returns:

true if the stanza(/packet) listener was removed

addSyncStanzaListener

void addSyncStanzaListener(StanzaListener packetListener,
                         StanzaFilter packetFilter)

Registers a synchronous stanza(/packet) listener with this connection. A stanza(/packet) listener will be invoked only when an incoming stanza(/packet) is received. A stanza(/packet) filter determines which packets will be delivered to the listener. If the same stanza(/packet) listener is added again with a different filter, only the new filter will be used.

Important: This stanza(/packet) listeners will be called in the same single thread that processes all incoming stanzas. Only use this kind of stanza(/packet) filter if it does not perform any XMPP activity that waits for a response. Consider using addAsyncStanzaListener(StanzaListener, StanzaFilter) when possible, i.e. when the invocation order doesn't have to be the same as the order of the arriving packets. If the order of the arriving packets, consider using a PacketCollector when possible.

Parameters:

packetListener - the stanza(/packet) listener to notify of new received packets.

packetFilter - the stanza(/packet) filter to use.

Since:

4.1

See Also:

addPacketInterceptor(StanzaListener, StanzaFilter)

removeSyncStanzaListener

boolean removeSyncStanzaListener(StanzaListener packetListener)

Removes a stanza(/packet) listener for received packets from this connection.

Parameters:

packetListener - the stanza(/packet) listener to remove.

Returns:

true if the stanza(/packet) listener was removed

Since:

4.1

addAsyncStanzaListener

void addAsyncStanzaListener(StanzaListener packetListener,
                          StanzaFilter packetFilter)

Registers an asynchronous stanza(/packet) listener with this connection. A stanza(/packet) listener will be invoked only when an incoming stanza(/packet) is received. A stanza(/packet) filter determines which packets will be delivered to the listener. If the same stanza(/packet) listener is added again with a different filter, only the new filter will be used.

Unlike addAsyncStanzaListener(StanzaListener, StanzaFilter) stanza(/packet) listeners added with this method will be invoked asynchronously in their own thread. Use this method if the order of the stanza(/packet) listeners must not depend on the order how the stanzas where received.

Parameters:

packetListener - the stanza(/packet) listener to notify of new received packets.

packetFilter - the stanza(/packet) filter to use.

Since:

4.1

See Also:

addPacketInterceptor(StanzaListener, StanzaFilter)

removeAsyncStanzaListener

boolean removeAsyncStanzaListener(StanzaListener packetListener)

Removes an asynchronous stanza(/packet) listener for received packets from this connection.

Parameters:

packetListener - the stanza(/packet) listener to remove.

Returns:

true if the stanza(/packet) listener was removed

Since:

4.1

addPacketSendingListener

void addPacketSendingListener(StanzaListener packetListener,
                            StanzaFilter packetFilter)

Registers a stanza(/packet) listener with this connection. The listener will be notified of every stanza(/packet) that this connection sends. A stanza(/packet) filter determines which packets will be delivered to the listener. Note that the thread that writes packets will be used to invoke the listeners. Therefore, each stanza(/packet) listener should complete all operations quickly or use a different thread for processing.

Parameters:

packetListener - the stanza(/packet) listener to notify of sent packets.

packetFilter - the stanza(/packet) filter to use.

removePacketSendingListener

void removePacketSendingListener(StanzaListener packetListener)

Removes a stanza(/packet) listener for sending packets from this connection.

Parameters:

packetListener - the stanza(/packet) listener to remove.

addPacketInterceptor

void addPacketInterceptor(StanzaListener packetInterceptor,
                        StanzaFilter packetFilter)

Registers a stanza(/packet) interceptor with this connection. The interceptor will be invoked every time a stanza(/packet) is about to be sent by this connection. Interceptors may modify the stanza(/packet) to be sent. A stanza(/packet) filter determines which packets will be delivered to the interceptor.

NOTE: For a similar functionality on incoming packets, see addAsyncStanzaListener(StanzaListener, StanzaFilter).

Parameters:

packetInterceptor - the stanza(/packet) interceptor to notify of packets about to be sent.

packetFilter - the stanza(/packet) filter to use.

removePacketInterceptor

void removePacketInterceptor(StanzaListener packetInterceptor)

Removes a stanza(/packet) interceptor.

Parameters:

packetInterceptor - the stanza(/packet) interceptor to remove.

getPacketReplyTimeout

long getPacketReplyTimeout()

Returns the current value of the reply timeout in milliseconds for request for this XMPPConnection instance.

Returns:

the stanza(/packet) reply timeout in milliseconds

setPacketReplyTimeout

void setPacketReplyTimeout(long timeout)

Set the stanza(/packet) reply timeout in milliseconds. In most cases, Smack will throw a SmackException.NoResponseException if no reply to a request was received within the timeout period.

Parameters:

timeout - the stanza(/packet) reply timeout in milliseconds

getConnectionCounter

int getConnectionCounter()

Get the connection counter of this XMPPConnection instance. Those can be used as ID to identify the connection, but beware that the ID may not be unique if you create more then 2*Integer.MAX_VALUE instances as the counter could wrap.

Returns:

the connection counter of this XMPPConnection

setFromMode

void setFromMode(XMPPConnection.FromMode fromMode)

Set the FromMode for this connection instance. Defines how the 'from' attribute of outgoing stanzas should be populated by Smack.

Parameters:

fromMode -

getFromMode

XMPPConnection.FromMode getFromMode()

Get the currently active FromMode.

Returns:

the currently active XMPPConnection.FromMode

getFeature

<F extends ExtensionElement> F getFeature(String element,
                                        String namespace)

Get the feature stanza(/packet) extensions for a given stream feature of the server, or null if the server doesn't support that feature.

Parameters:

element -

namespace -

Returns:

a stanza(/packet) extensions of the feature or null

hasFeature

boolean hasFeature(String element,
                 String namespace)

Return true if the server supports the given stream feature.

Parameters:

element -

namespace -

Returns:

true if the server supports the stream feature.

sendStanzaWithResponseCallback

void sendStanzaWithResponseCallback(Stanza stanza,
                                  StanzaFilter replyFilter,
                                  StanzaListener callback)
                                    throws SmackException.NotConnectedException

Send a stanza and wait asynchronously for a response by using replyFilter.

If there is a response, then callback will be invoked. The callback will be invoked at most once and it will be not invoked after the connections default reply timeout has been elapsed.

Parameters:

stanza - the stanza to send (required)

replyFilter - the filter used to determine response stanza (required)

callback - the callback invoked if there is a response (required)

Throws:

SmackException.NotConnectedException

sendStanzaWithResponseCallback

void sendStanzaWithResponseCallback(Stanza stanza,
                                  StanzaFilter replyFilter,
                                  StanzaListener callback,
                                  ExceptionCallback exceptionCallback)
                                    throws SmackException.NotConnectedException

Send a stanza and wait asynchronously for a response by using replyFilter.

If there is a response, then callback will be invoked. If there is no response after the connections default reply timeout, then exceptionCallback will be invoked with a SmackException.NoResponseException. The callback will be invoked at most once.

Parameters:

stanza - the stanza to send (required)

replyFilter - the filter used to determine response stanza (required)

callback - the callback invoked if there is a response (required)

exceptionCallback - the callback invoked if there is an exception (optional)

Throws:

SmackException.NotConnectedException

sendStanzaWithResponseCallback

void sendStanzaWithResponseCallback(Stanza stanza,
                                  StanzaFilter replyFilter,
                                  StanzaListener callback,
                                  ExceptionCallback exceptionCallback,
                                  long timeout)
                                    throws SmackException.NotConnectedException

Send a stanza and wait asynchronously for a response by using replyFilter.

If there is a response, then callback will be invoked. If there is no response after timeout milliseconds, then exceptionCallback will be invoked with a SmackException.NoResponseException. The callback will be invoked at most once.

Parameters:

stanza - the stanza to send (required)

replyFilter - the filter used to determine response stanza (required)

callback - the callback invoked if there is a response (required)

exceptionCallback - the callback invoked if there is an exception (optional)

timeout - the timeout in milliseconds to wait for a response

Throws:

SmackException.NotConnectedException

sendIqWithResponseCallback

void sendIqWithResponseCallback(IQ iqRequest,
                              StanzaListener callback)
                                throws SmackException.NotConnectedException

Send a IQ stanza and invoke callback if there is a result of IQ.Type.result with that result IQ. The callback will not be invoked after the connections default reply timeout has been elapsed.

Parameters:

iqRequest - the IQ stanza to send (required)

callback - the callback invoked if there is result response (required)

Throws:

SmackException.NotConnectedException

sendIqWithResponseCallback

void sendIqWithResponseCallback(IQ iqRequest,
                              StanzaListener callback,
                              ExceptionCallback exceptionCallback)
                                throws SmackException.NotConnectedException

Send a IQ stanza and invoke callback if there is a result of IQ.Type.result with that result IQ. If there is an error response exceptionCallback will be invoked, if not null, with the received error as XMPPException.XMPPErrorException. If there is no response after the connections default reply timeout, then exceptionCallback will be invoked with a SmackException.NoResponseException.

Parameters:

iqRequest - the IQ stanza to send (required)

callback - the callback invoked if there is result response (required)

exceptionCallback - the callback invoked if there is an Exception optional

Throws:

SmackException.NotConnectedException

sendIqWithResponseCallback

void sendIqWithResponseCallback(IQ iqRequest,
                              StanzaListener callback,
                              ExceptionCallback exceptionCallback,
                              long timeout)
                                throws SmackException.NotConnectedException

Send a IQ stanza and invoke callback if there is a result of IQ.Type.result with that result IQ. If there is an error response exceptionCallback will be invoked, if not null, with the received error as XMPPException.XMPPErrorException. If there is no response after timeout, then exceptionCallback will be invoked with a SmackException.NoResponseException.

Parameters:

iqRequest - the IQ stanza to send (required)

callback - the callback invoked if there is result response (required)

exceptionCallback - the callback invoked if there is an Exception optional

timeout - the timeout in milliseconds to wait for a response

Throws:

SmackException.NotConnectedException

addOneTimeSyncCallback

void addOneTimeSyncCallback(StanzaListener callback,
                          StanzaFilter packetFilter)

Add a callback that is called exactly once and synchronously with the incoming stanza that matches the given stanza(/packet) filter.

Parameters:

callback - the callback invoked once the stanza(/packet) filter matches a stanza.

packetFilter - the filter to match stanzas or null to match all.

registerIQRequestHandler

IQRequestHandler registerIQRequestHandler(IQRequestHandler iqRequestHandler)

Register an IQ request handler with this connection.

IQ request handler process incoming IQ requests, i.e. incoming IQ stanzas of type 'get' or 'set', and return a result.

Parameters:

iqRequestHandler - the IQ request handler to register.

Returns:

the previously registered IQ request handler or null.

unregisterIQRequestHandler

IQRequestHandler unregisterIQRequestHandler(IQRequestHandler iqRequestHandler)

Convenience method for unregisterIQRequestHandler(String, String, org.jivesoftware.smack.packet.IQ.Type).

Parameters:

iqRequestHandler -

Returns:

the previously registered IQ request handler or null.

unregisterIQRequestHandler

IQRequestHandler unregisterIQRequestHandler(String element,
                                          String namespace,
                                          IQ.Type type)

Unregister an IQ request handler with this connection.

Parameters:

element - the IQ element the IQ request handler is responsible for.

namespace - the IQ namespace the IQ request handler is responsible for.

type - the IQ type the IQ request handler is responsible for.

Returns:

the previously registered IQ request handler or null.

getLastStanzaReceived

long getLastStanzaReceived()

Returns the timestamp in milliseconds when the last stanza was received.

Returns:

the timestamp in milliseconds