public abstract class AbstractXMPPConnection extends java.lang.Object implements XMPPConnection
| Modifier and Type | Class and Description |
|---|---|
protected static class |
AbstractXMPPConnection.InterceptorWrapper
A wrapper class to associate a packet filter with an interceptor.
|
protected static class |
AbstractXMPPConnection.ListenerWrapper
A wrapper class to associate a packet filter with a listener.
|
XMPPConnection.FromMode| Modifier and Type | Field and Description |
|---|---|
protected boolean |
authenticated
Flag that indicates if the user is currently authenticated with the server.
|
protected XMPPInputOutputStream |
compressionHandler |
protected ConnectionConfiguration |
config
Holds the initial configuration used while creating the connection.
|
protected boolean |
connected |
protected int |
connectionCounterValue
A number to uniquely identify connections that are created.
|
protected java.util.Set<ConnectionListener> |
connectionListeners
A collection of ConnectionListeners which listen for connection closing
and reconnection events.
|
protected java.util.concurrent.locks.Lock |
connectionLock |
protected SmackDebugger |
debugger
The SmackDebugger allows to log and debug XML traffic.
|
protected java.lang.String |
host
The used host to establish the connection to
|
protected java.util.List<HostAddress> |
hostAddresses |
protected SynchronizationPoint<java.lang.Exception> |
lastFeaturesReceived
Set to success if the last features stanza from the server has been parsed.
|
protected int |
port
The used port to establish the connection to
|
protected java.io.Reader |
reader
The Reader which is used for the debugger.
|
protected SASLAuthentication |
saslAuthentication
The SASLAuthentication manager that is responsible for authenticating with the server.
|
protected SynchronizationPoint<SmackException> |
saslFeatureReceived
Set to success if the sasl feature has been received.
|
protected java.util.Map<java.lang.String,PacketExtension> |
streamFeatures |
protected java.lang.String |
streamId
The stream ID, see RFC 6120 § 4.7.3
|
protected java.lang.String |
user
The full JID of the authenticated user, as returned by the resource binding response of the server.
|
protected boolean |
wasAuthenticated
Flag that indicates if the user was authenticated with the server when the connection
to the server was closed (abruptly or not).
|
protected java.io.Writer |
writer
The Writer which is used for the debugger.
|
| Modifier | Constructor and Description |
|---|---|
protected |
AbstractXMPPConnection(ConnectionConfiguration configuration)
Create a new XMPPConnection to an XMPP server.
|
| Modifier and Type | Method and Description |
|---|---|
void |
addAsyncPacketListener(PacketListener packetListener,
PacketFilter packetFilter)
Registers an asynchronous 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(PacketListener callback,
PacketFilter packetFilter)
Add a callback that is called exactly once and synchronously with the incoming stanza that matches the given
packet filter.
|
void |
addPacketInterceptor(PacketListener packetInterceptor,
PacketFilter packetFilter)
Registers a packet interceptor with this connection.
|
void |
addPacketListener(PacketListener packetListener,
PacketFilter packetFilter)
Deprecated.
|
void |
addPacketSendingListener(PacketListener packetListener,
PacketFilter packetFilter)
Registers a packet listener with this connection.
|
void |
addSyncPacketListener(PacketListener packetListener,
PacketFilter packetFilter)
Registers a synchronous packet listener with this connection.
|
protected void |
afterFeaturesReceived() |
protected void |
afterSuccessfulLogin(boolean resumed) |
protected void |
asyncGo(java.lang.Runnable runnable) |
protected void |
bindResourceAndEstablishSession(java.lang.String resource) |
protected void |
callConnectionAuthenticatedListener(boolean resumed) |
protected void |
callConnectionClosedOnErrorListener(java.lang.Exception e) |
protected void |
callConnectionConnectedListener() |
AbstractXMPPConnection |
connect()
Establishes a connection to the XMPP server and performs an automatic login
only if the previous connection state was logged (authenticated).
|
protected abstract void |
connectInternal()
Abstract method that concrete subclasses of XMPPConnection need to implement to perform their
way of XMPP connection establishment.
|
PacketCollector |
createPacketCollector(PacketCollector.Configuration configuration)
Create a new packet collector with the given packet collector configuration.
|
PacketCollector |
createPacketCollector(PacketFilter packetFilter)
Creates a new packet collector for this connection.
|
PacketCollector |
createPacketCollectorAndSend(IQ packet)
Creates a new packet collector collecting packets that are replies to
packet. |
PacketCollector |
createPacketCollectorAndSend(PacketFilter packetFilter,
Stanza packet)
Creates a new packet collector for this connection.
|
void |
disconnect()
Closes the connection by setting presence to unavailable then closing the connection to
the XMPP server.
|
void |
disconnect(Presence unavailablePresence)
Closes the connection.
|
protected void |
finalize() |
protected void |
firePacketSendingListeners(Stanza packet)
Process all packet listeners for sending packets.
|
protected ConnectionConfiguration |
getConfiguration() |
int |
getConnectionCounter()
Get the connection counter of this XMPPConnection instance.
|
protected static java.util.Collection<ConnectionCreationListener> |
getConnectionCreationListeners()
Get the collection of listeners that are interested in connection creation events.
|
protected java.util.concurrent.locks.Lock |
getConnectionLock() |
<F extends PacketExtension> |
getFeature(java.lang.String element,
java.lang.String namespace)
Get the feature 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.
|
java.lang.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.
|
ParsingExceptionCallback |
getParsingExceptionCallback()
Get the current active parsing exception callback.
|
int |
getPort()
Returns the port number of the XMPP server for this connection.
|
protected SASLAuthentication |
getSASLAuthentication()
Returns the SASLAuthentication manager that is responsible for authenticating with
the server.
|
java.lang.String |
getServiceName()
Returns the name of the service provided by the XMPP server for this connection.
|
java.lang.String |
getStreamId()
Returns the stream ID for this connection, which is the value set by the server
when opening an XMPP stream.
|
java.lang.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(java.lang.String element,
java.lang.String namespace)
Return true if the server supports the given stream feature.
|
protected void |
initDebugger()
Initialize the
debugger. |
protected void |
invokePacketCollectorsAndNotifyRecvListeners(Stanza packet)
Invoke
PacketCollector.processPacket(Stanza) for every
PacketCollector with the given packet. |
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.
|
abstract boolean |
isSecureConnection()
Returns true if the connection to the server has successfully negotiated encryption.
|
abstract boolean |
isUsingCompression()
Returns true if network traffic is being compressed.
|
void |
login()
Logs in to the server using the strongest SASL mechanism supported by
the server.
|
void |
login(java.lang.CharSequence username,
java.lang.String password)
Same as
login(CharSequence, String, String), but takes the resource from the connection
configuration. |
void |
login(java.lang.CharSequence username,
java.lang.String password,
java.lang.String resource)
Login with the given username (authorization identity).
|
protected abstract void |
loginAnonymously() |
protected abstract void |
loginNonAnonymously(java.lang.String username,
java.lang.String password,
java.lang.String resource) |
protected void |
notifyReconnection()
Sends a notification indicating that the connection was reconnected successfully.
|
protected void |
parseAndProcessStanza(org.xmlpull.v1.XmlPullParser parser) |
protected void |
parseFeatures(org.xmlpull.v1.XmlPullParser parser) |
protected java.util.List<HostAddress> |
populateHostAddresses()
Populates
hostAddresses with at least one host address. |
protected void |
processPacket(Stanza packet)
Processes a packet after it's been fully parsed by looping through the installed
packet collectors and listeners and letting them examine the packet to see if
they are a match with the filter.
|
IQRequestHandler |
registerIQRequestHandler(IQRequestHandler iqRequestHandler)
Register an IQ request handler with this connection.
|
boolean |
removeAsyncPacketListener(PacketListener packetListener)
Removes an asynchronous 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 packet collector of this connection.
|
void |
removePacketInterceptor(PacketListener packetInterceptor)
Removes a packet interceptor.
|
boolean |
removePacketListener(PacketListener packetListener)
Deprecated.
|
void |
removePacketSendingListener(PacketListener packetListener)
Removes a packet listener for sending packets from this connection.
|
boolean |
removeSyncPacketListener(PacketListener packetListener)
Removes a packet listener for received packets from this connection.
|
protected java.util.concurrent.ScheduledFuture<?> |
schedule(java.lang.Runnable runnable,
long delay,
java.util.concurrent.TimeUnit unit) |
abstract void |
send(PlainStreamElement element)
Send a PlainStreamElement.
|
void |
sendIqWithResponseCallback(IQ iqRequest,
PacketListener 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,
PacketListener 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,
PacketListener 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)
Sends the specified packet to the server.
|
protected abstract void |
sendPacketInternal(Stanza packet) |
void |
sendStanzaWithResponseCallback(Stanza stanza,
PacketFilter replyFilter,
PacketListener callback)
Send a stanza and wait asynchronously for a response by using
replyFilter. |
void |
sendStanzaWithResponseCallback(Stanza stanza,
PacketFilter replyFilter,
PacketListener callback,
ExceptionCallback exceptionCallback)
Send a stanza and wait asynchronously for a response by using
replyFilter. |
void |
sendStanzaWithResponseCallback(Stanza stanza,
PacketFilter replyFilter,
PacketListener callback,
ExceptionCallback exceptionCallback,
long timeout)
Send a stanza and wait asynchronously for a response by using
replyFilter. |
static void |
setConcurrencyLevel(int concurrencyLevel)
Set the concurrency level used by newly created connections.
|
void |
setFromMode(XMPPConnection.FromMode fromMode)
Set the FromMode for this connection instance.
|
void |
setPacketReplyTimeout(long timeout)
Set the packet reply timeout in milliseconds.
|
void |
setParsingExceptionCallback(ParsingExceptionCallback callback)
Install a parsing exception callback, which will be invoked once an exception is encountered while parsing a
stanza
|
void |
setReplyToUnknownIq(boolean replyToUnknownIq)
Set if Smack will automatically send
XMPPError.Condition.feature_not_implemented when a request IQ without a
registered IQRequestHandler is received. |
static void |
setReplyToUnknownIqDefault(boolean replyToUnkownIqDefault)
Set the default value used to determine if new connection will reply to unknown IQ requests.
|
protected void |
setWasAuthenticated()
Sets whether the connection has already logged in the server.
|
protected abstract void |
shutdown()
Shuts the current connection down.
|
protected void |
throwAlreadyConnectedExceptionIfAppropriate() |
protected void |
throwAlreadyLoggedInExceptionIfAppropriate() |
protected void |
throwNotConnectedExceptionIfAppropriate() |
IQRequestHandler |
unregisterIQRequestHandler(IQRequestHandler iqRequestHandler)
Convenience method for
XMPPConnection.unregisterIQRequestHandler(String, String, org.jivesoftware.smack.packet.IQ.Type). |
IQRequestHandler |
unregisterIQRequestHandler(java.lang.String element,
java.lang.String namespace,
IQ.Type type)
Unregister an IQ request handler with this connection.
|
protected final java.util.Set<ConnectionListener> connectionListeners
protected final java.util.concurrent.locks.Lock connectionLock
protected final java.util.Map<java.lang.String,PacketExtension> streamFeatures
protected java.lang.String user
It is important that we don't infer the user from the login() arguments and the configurations service name, as, for example, when SASL External is used, the username is not given to login but taken from the 'external' certificate.
protected boolean connected
protected java.lang.String streamId
protected SmackDebugger debugger
protected java.io.Reader reader
protected java.io.Writer writer
protected final SynchronizationPoint<java.lang.Exception> lastFeaturesReceived
protected final SynchronizationPoint<SmackException> saslFeatureReceived
protected SASLAuthentication saslAuthentication
protected final int connectionCounterValue
protected final ConnectionConfiguration config
protected XMPPInputOutputStream compressionHandler
protected java.lang.String host
protected int port
protected boolean authenticated
protected boolean wasAuthenticated
protected java.util.List<HostAddress> hostAddresses
protected AbstractXMPPConnection(ConnectionConfiguration configuration)
configuration - The configuration which is used to establish the connection.protected static java.util.Collection<ConnectionCreationListener> getConnectionCreationListeners()
public static void setConcurrencyLevel(int concurrencyLevel)
The concurrency level determines the maximum pool size of the executor service that is used to e.g. invoke callbacks and IQ request handlers.
The default value is Runtime.getRuntime().availableProcessors() + 1. Note that the number of
available processors may change at runtime. So you may need to adjust it to your enviornment, although in most
cases this should not be necessary.
concurrencyLevel - the concurrency level used by new connections.protected ConnectionConfiguration getConfiguration()
public java.lang.String getServiceName()
XMPPConnectiongetServiceName in interface XMPPConnectionpublic java.lang.String getHost()
XMPPConnectiongetHost in interface XMPPConnectionpublic int getPort()
XMPPConnectiongetPort in interface XMPPConnectionpublic abstract boolean isSecureConnection()
XMPPConnectionisSecureConnection in interface XMPPConnectionprotected abstract void sendPacketInternal(Stanza packet) throws SmackException.NotConnectedException
public abstract void send(PlainStreamElement element) throws SmackException.NotConnectedException
XMPPConnectionThis 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.
send in interface XMPPConnectionSmackException.NotConnectedExceptionpublic abstract boolean isUsingCompression()
XMPPConnectionisUsingCompression in interface XMPPConnectionpublic AbstractXMPPConnection connect() throws SmackException, java.io.IOException, XMPPException
Listeners will be preserved from a previous connection.
connect() with login().XMPPException - if an error occurs on the XMPP protocol level.SmackException - if an error occurs somewhere else besides XMPP protocol level.java.io.IOExceptionSmackException.ConnectionException - with detailed information about the failed connection.protected abstract void connectInternal()
throws SmackException,
java.io.IOException,
XMPPException
SmackExceptionjava.io.IOExceptionXMPPExceptionpublic void login()
throws XMPPException,
SmackException,
java.io.IOException
SmackException.NoResponseException will be thrown.
Before logging in (i.e. authenticate) to the server the connection must be connected
by calling connect().
It is possible to log in without sending an initial available presence by using
ConnectionConfiguration.Builder.setSendPresence(boolean).
Finally, if you want to not pass a password and instead use a more advanced mechanism
while using SASL then you may be interested in using
ConnectionConfiguration.Builder.setCallbackHandler(javax.security.auth.callback.CallbackHandler).
For more advanced login settings see ConnectionConfiguration.
XMPPException - if an error occurs on the XMPP protocol level.SmackException - if an error occurs somewhere else besides XMPP protocol level.java.io.IOException - if an I/O error occurs during login.public void login(java.lang.CharSequence username,
java.lang.String password)
throws XMPPException,
SmackException,
java.io.IOException
login(CharSequence, String, String), but takes the resource from the connection
configuration.username - password - XMPPExceptionSmackExceptionjava.io.IOExceptionlogin()public void login(java.lang.CharSequence username,
java.lang.String password,
java.lang.String resource)
throws XMPPException,
SmackException,
java.io.IOException
username - password - resource - XMPPExceptionSmackExceptionjava.io.IOExceptionlogin()protected abstract void loginNonAnonymously(java.lang.String username,
java.lang.String password,
java.lang.String resource)
throws XMPPException,
SmackException,
java.io.IOException
XMPPExceptionSmackExceptionjava.io.IOExceptionprotected abstract void loginAnonymously()
throws XMPPException,
SmackException,
java.io.IOException
XMPPExceptionSmackExceptionjava.io.IOExceptionpublic final boolean isConnected()
XMPPConnectionisConnected in interface XMPPConnectionpublic final boolean isAuthenticated()
XMPPConnectionisAuthenticated in interface XMPPConnectionpublic final java.lang.String getUser()
XMPPConnectiongetUser in interface XMPPConnectionpublic java.lang.String getStreamId()
XMPPConnectiongetStreamId in interface XMPPConnectionprotected void bindResourceAndEstablishSession(java.lang.String resource)
throws XMPPException.XMPPErrorException,
java.io.IOException,
SmackException
XMPPException.XMPPErrorExceptionjava.io.IOExceptionSmackExceptionprotected void afterSuccessfulLogin(boolean resumed)
throws SmackException.NotConnectedException
public final boolean isAnonymous()
XMPPConnectionisAnonymous in interface XMPPConnectionprotected java.util.List<HostAddress> populateHostAddresses()
hostAddresses with at least one host address.protected java.util.concurrent.locks.Lock getConnectionLock()
protected void throwNotConnectedExceptionIfAppropriate()
throws SmackException.NotConnectedException
protected void throwAlreadyConnectedExceptionIfAppropriate()
throws SmackException.AlreadyConnectedException
protected void throwAlreadyLoggedInExceptionIfAppropriate()
throws SmackException.AlreadyLoggedInException
public void sendPacket(Stanza packet) throws SmackException.NotConnectedException
XMPPConnectionsendPacket in interface XMPPConnectionpacket - the packet to send.SmackException.NotConnectedExceptionprotected SASLAuthentication getSASLAuthentication()
public void disconnect()
public void disconnect(Presence unavailablePresence) throws SmackException.NotConnectedException
unavailablePresence - the presence packet to send during shutdown.SmackException.NotConnectedExceptionprotected abstract void shutdown()
public void addConnectionListener(ConnectionListener connectionListener)
XMPPConnectionaddConnectionListener in interface XMPPConnectionconnectionListener - a connection listener.public void removeConnectionListener(ConnectionListener connectionListener)
XMPPConnectionremoveConnectionListener in interface XMPPConnectionconnectionListener - a connection listener.public PacketCollector createPacketCollectorAndSend(IQ packet) throws SmackException.NotConnectedException
XMPPConnectionpacket.
Does also send packet. The packet filter for the collector is an
IQReplyFilter, guaranteeing that packet id and JID in the 'from' address have
expected values.createPacketCollectorAndSend in interface XMPPConnectionpacket - the packet to filter responses fromSmackException.NotConnectedExceptionpublic PacketCollector createPacketCollectorAndSend(PacketFilter packetFilter, Stanza packet) throws SmackException.NotConnectedException
XMPPConnectionPacketListener when you need to wait for
a specific result.createPacketCollectorAndSend in interface XMPPConnectionpacketFilter - the packet filter to use.packet - the packet to send right after the collector got createdSmackException.NotConnectedExceptionpublic PacketCollector createPacketCollector(PacketFilter packetFilter)
XMPPConnectionPacketListener
when you need to wait for a specific result.
Note: If you send a Packet right after using this method, then
consider using
XMPPConnection.createPacketCollectorAndSend(PacketFilter, 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.
createPacketCollector in interface XMPPConnectionpacketFilter - the packet filter to use.public PacketCollector createPacketCollector(PacketCollector.Configuration configuration)
XMPPConnection
Please make sure to cancel the collector when it is no longer required. See also
XMPPConnection.createPacketCollector(PacketFilter).
createPacketCollector in interface XMPPConnectionconfiguration - the packet collector configuration.public void removePacketCollector(PacketCollector collector)
XMPPConnectionremovePacketCollector in interface XMPPConnectioncollector - a packet collectors which was created for this connection.@Deprecated public void addPacketListener(PacketListener packetListener, PacketFilter packetFilter)
XMPPConnection
This method has been deprecated. It is important to differentiate between using an asynchronous packet listener
(preferred where possible) and a synchronous packet lister. Refer
XMPPConnection.addAsyncPacketListener(PacketListener, PacketFilter) and
XMPPConnection.addSyncPacketListener(PacketListener, PacketFilter) for more information.
addPacketListener in interface XMPPConnectionpacketListener - the packet listener to notify of new received packets.packetFilter - the packet filter to use.@Deprecated public boolean removePacketListener(PacketListener packetListener)
XMPPConnectionremovePacketListener in interface XMPPConnectionpacketListener - the packet listener to remove.public void addSyncPacketListener(PacketListener packetListener, PacketFilter packetFilter)
XMPPConnection
Important: This packet listeners will be called in the same single thread that processes all
incoming stanzas. Only use this kind of packet filter if it does not perform any XMPP activity that waits for a
response. Consider using XMPPConnection.addAsyncPacketListener(PacketListener, PacketFilter) 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.
addSyncPacketListener in interface XMPPConnectionpacketListener - the packet listener to notify of new received packets.packetFilter - the packet filter to use.XMPPConnection.addPacketInterceptor(PacketListener, PacketFilter)public boolean removeSyncPacketListener(PacketListener packetListener)
XMPPConnectionremoveSyncPacketListener in interface XMPPConnectionpacketListener - the packet listener to remove.public void addAsyncPacketListener(PacketListener packetListener, PacketFilter packetFilter)
XMPPConnection
Unlike XMPPConnection.addAsyncPacketListener(PacketListener, PacketFilter) packet listeners added with this method will be
invoked asynchronously in their own thread. Use this method if the order of the packet listeners must not depend
on the order how the stanzas where received.
addAsyncPacketListener in interface XMPPConnectionpacketListener - the packet listener to notify of new received packets.packetFilter - the packet filter to use.XMPPConnection.addPacketInterceptor(PacketListener, PacketFilter)public boolean removeAsyncPacketListener(PacketListener packetListener)
XMPPConnectionremoveAsyncPacketListener in interface XMPPConnectionpacketListener - the packet listener to remove.public void addPacketSendingListener(PacketListener packetListener, PacketFilter packetFilter)
XMPPConnectionaddPacketSendingListener in interface XMPPConnectionpacketListener - the packet listener to notify of sent packets.packetFilter - the packet filter to use.public void removePacketSendingListener(PacketListener packetListener)
XMPPConnectionremovePacketSendingListener in interface XMPPConnectionpacketListener - the packet listener to remove.protected void firePacketSendingListeners(Stanza packet)
Compared to firePacketInterceptors(Stanza), the listeners will be invoked in a new thread.
packet - the packet to process.public void addPacketInterceptor(PacketListener packetInterceptor, PacketFilter packetFilter)
XMPPConnection
NOTE: For a similar functionality on incoming packets, see XMPPConnection.addAsyncPacketListener(PacketListener, PacketFilter).
addPacketInterceptor in interface XMPPConnectionpacketInterceptor - the packet interceptor to notify of packets about to be sent.packetFilter - the packet filter to use.public void removePacketInterceptor(PacketListener packetInterceptor)
XMPPConnectionremovePacketInterceptor in interface XMPPConnectionpacketInterceptor - the packet interceptor to remove.protected void initDebugger()
debugger. You can specify a customized SmackDebugger
by setup the system property smack.debuggerClass to the implementation.java.lang.IllegalStateException - if the reader or writer isn't yet initialized.java.lang.IllegalArgumentException - if the SmackDebugger can't be loaded.public long getPacketReplyTimeout()
XMPPConnectiongetPacketReplyTimeout in interface XMPPConnectionpublic void setPacketReplyTimeout(long timeout)
XMPPConnectionSmackException.NoResponseException if no reply to a request was received within the timeout period.setPacketReplyTimeout in interface XMPPConnectiontimeout - the packet reply timeout in millisecondspublic static void setReplyToUnknownIqDefault(boolean replyToUnkownIqDefault)
replyToUnkownIqDefault - setReplyToUnknownIq(boolean)public void setReplyToUnknownIq(boolean replyToUnknownIq)
XMPPError.Condition.feature_not_implemented when a request IQ without a
registered IQRequestHandler is received.replyToUnknownIq - protected void parseAndProcessStanza(org.xmlpull.v1.XmlPullParser parser)
throws java.lang.Exception
java.lang.Exceptionprotected void processPacket(Stanza packet)
packet - the packet to process.protected void invokePacketCollectorsAndNotifyRecvListeners(Stanza packet)
PacketCollector.processPacket(Stanza) for every
PacketCollector with the given packet. Also notify the receive listeners with a matching packet filter about the packet.packet - the packet to notify the PacketCollectors and receive listeners about.protected void setWasAuthenticated()
wasAuthenticated flag is never reset once it has ever been set.protected void callConnectionConnectedListener()
protected void callConnectionAuthenticatedListener(boolean resumed)
protected void callConnectionClosedOnErrorListener(java.lang.Exception e)
protected void notifyReconnection()
public int getConnectionCounter()
XMPPConnectiongetConnectionCounter in interface XMPPConnectionpublic void setFromMode(XMPPConnection.FromMode fromMode)
XMPPConnectionsetFromMode in interface XMPPConnectionpublic XMPPConnection.FromMode getFromMode()
XMPPConnectiongetFromMode in interface XMPPConnectionXMPPConnection.FromModeprotected void finalize()
throws java.lang.Throwable
finalize in class java.lang.Objectjava.lang.Throwableprotected final void parseFeatures(org.xmlpull.v1.XmlPullParser parser)
throws org.xmlpull.v1.XmlPullParserException,
java.io.IOException,
SmackException
org.xmlpull.v1.XmlPullParserExceptionjava.io.IOExceptionSmackExceptionprotected void afterFeaturesReceived()
throws SmackException.SecurityRequiredException,
SmackException.NotConnectedException
public <F extends PacketExtension> F getFeature(java.lang.String element, java.lang.String namespace)
XMPPConnectionnull if the server doesn't support that feature.getFeature in interface XMPPConnectionnullpublic boolean hasFeature(java.lang.String element,
java.lang.String namespace)
XMPPConnectionhasFeature in interface XMPPConnectionpublic void sendStanzaWithResponseCallback(Stanza stanza, PacketFilter replyFilter, PacketListener callback) throws SmackException.NotConnectedException
XMPPConnectionreplyFilter.
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.
sendStanzaWithResponseCallback in interface XMPPConnectionstanza - the stanza to send (required)replyFilter - the filter used to determine response stanza (required)callback - the callback invoked if there is a response (required)SmackException.NotConnectedExceptionpublic void sendStanzaWithResponseCallback(Stanza stanza, PacketFilter replyFilter, PacketListener callback, ExceptionCallback exceptionCallback) throws SmackException.NotConnectedException
XMPPConnectionreplyFilter.
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.
sendStanzaWithResponseCallback in interface XMPPConnectionstanza - 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)SmackException.NotConnectedExceptionpublic void sendStanzaWithResponseCallback(Stanza stanza, PacketFilter replyFilter, PacketListener callback, ExceptionCallback exceptionCallback, long timeout) throws SmackException.NotConnectedException
XMPPConnectionreplyFilter.
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.
sendStanzaWithResponseCallback in interface XMPPConnectionstanza - 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 responseSmackException.NotConnectedExceptionpublic void sendIqWithResponseCallback(IQ iqRequest, PacketListener callback) throws SmackException.NotConnectedException
XMPPConnectioncallback 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.sendIqWithResponseCallback in interface XMPPConnectioniqRequest - the IQ stanza to send (required)callback - the callback invoked if there is result response (required)SmackException.NotConnectedExceptionpublic void sendIqWithResponseCallback(IQ iqRequest, PacketListener callback, ExceptionCallback exceptionCallback) throws SmackException.NotConnectedException
XMPPConnectioncallback 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.sendIqWithResponseCallback in interface XMPPConnectioniqRequest - 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 optionalSmackException.NotConnectedExceptionpublic void sendIqWithResponseCallback(IQ iqRequest, PacketListener callback, ExceptionCallback exceptionCallback, long timeout) throws SmackException.NotConnectedException
XMPPConnectioncallback 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.sendIqWithResponseCallback in interface XMPPConnectioniqRequest - 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 optionaltimeout - the timeout in milliseconds to wait for a responseSmackException.NotConnectedExceptionpublic void addOneTimeSyncCallback(PacketListener callback, PacketFilter packetFilter)
XMPPConnectionaddOneTimeSyncCallback in interface XMPPConnectioncallback - the callback invoked once the packet filter matches a stanza.packetFilter - the filter to match stanzas or null to match all.public IQRequestHandler registerIQRequestHandler(IQRequestHandler iqRequestHandler)
XMPPConnectionIQ request handler process incoming IQ requests, i.e. incoming IQ stanzas of type 'get' or 'set', and return a result.
registerIQRequestHandler in interface XMPPConnectioniqRequestHandler - the IQ request handler to register.public final IQRequestHandler unregisterIQRequestHandler(IQRequestHandler iqRequestHandler)
XMPPConnectionXMPPConnection.unregisterIQRequestHandler(String, String, org.jivesoftware.smack.packet.IQ.Type).unregisterIQRequestHandler in interface XMPPConnectionpublic IQRequestHandler unregisterIQRequestHandler(java.lang.String element, java.lang.String namespace, IQ.Type type)
XMPPConnectionunregisterIQRequestHandler in interface XMPPConnectionelement - 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.public long getLastStanzaReceived()
XMPPConnectiongetLastStanzaReceived in interface XMPPConnectionpublic void setParsingExceptionCallback(ParsingExceptionCallback callback)
callback - the callback to installpublic ParsingExceptionCallback getParsingExceptionCallback()
protected final void asyncGo(java.lang.Runnable runnable)
protected final java.util.concurrent.ScheduledFuture<?> schedule(java.lang.Runnable runnable,
long delay,
java.util.concurrent.TimeUnit unit)