org.jivesoftware.smack

Class SynchronizationPoint<E extends Exception>

java.lang.Object

org.jivesoftware.smack.SynchronizationPoint<E>

public class SynchronizationPoint<E extends Exception>
extends Object

Constructor Summary

Constructors

Constructor and Description
SynchronizationPoint(AbstractXMPPConnection connection) Construct a new synchronization point for the given connection.

Method Summary

Modifier and Type	Method and Description
void	checkIfSuccessOrWait() Check if this synchronization point is successful or wait the connections reply timeout.
void	checkIfSuccessOrWaitOrThrow() Check if this synchronization point is successful or wait the connections reply timeout.
void	init() Initialize (or reset) this synchronization point.
void	reportFailure() Deprecated. use reportFailure(Exception) instead.
void	reportFailure(E failureException) Report this synchronization point as failed because of the given exception.
void	reportSuccess() Report this synchronization point as successful.
boolean	requestSent() Check if this synchronization point has its request already sent.
void	sendAndWaitForResponse(TopLevelStreamElement request) Send the given top level stream element and wait for a response.
void	sendAndWaitForResponseOrThrow(PlainStreamElement request) Send the given plain stream element and wait for a response.
boolean	wasSuccessful() Check if this synchronization point was successful.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SynchronizationPoint

public SynchronizationPoint(AbstractXMPPConnection connection)

Construct a new synchronization point for the given connection.

Parameters:

connection - the connection of this synchronization point.

Method Detail

init

public void init()

Initialize (or reset) this synchronization point.

sendAndWaitForResponse

public void sendAndWaitForResponse(TopLevelStreamElement request)
                            throws SmackException.NoResponseException,
                                   SmackException.NotConnectedException

Send the given top level stream element and wait for a response.

Parameters:

request - the plain stream element to send.

Throws:

SmackException.NoResponseException - if no response was received.

SmackException.NotConnectedException - if the connection is not connected.

sendAndWaitForResponseOrThrow

public void sendAndWaitForResponseOrThrow(PlainStreamElement request)
                                   throws E extends Exception,
                                          SmackException.NoResponseException,
                                          SmackException.NotConnectedException

Send the given plain stream element and wait for a response.

Parameters:

request - the plain stream element to send.

Throws:

E - if an failure was reported.

SmackException.NoResponseException - if no response was received.

SmackException.NotConnectedException - if the connection is not connected.

E extends Exception

checkIfSuccessOrWaitOrThrow

public void checkIfSuccessOrWaitOrThrow()
                                 throws SmackException.NoResponseException,
                                        E extends Exception

Check if this synchronization point is successful or wait the connections reply timeout.

Throws:

SmackException.NoResponseException - if there was no response marking the synchronization point as success or failed.

E - if there was a failure

E extends Exception

checkIfSuccessOrWait

public void checkIfSuccessOrWait()
                          throws SmackException.NoResponseException

Check if this synchronization point is successful or wait the connections reply timeout.

Throws:

SmackException.NoResponseException - if there was no response marking the synchronization point as success or failed.

reportSuccess

public void reportSuccess()

Report this synchronization point as successful.

reportFailure

@Deprecated
public void reportFailure()

Deprecated. use reportFailure(Exception) instead.

Deprecated

reportFailure

public void reportFailure(E failureException)

Report this synchronization point as failed because of the given exception. The failureException must be set.

Parameters:

failureException - the exception causing this synchronization point to fail.

wasSuccessful

public boolean wasSuccessful()

Check if this synchronization point was successful.

Returns:

true if the synchronization point was successful, false otherwise.

requestSent

public boolean requestSent()

Check if this synchronization point has its request already sent.

Returns:

true if the request was already sent, false otherwise.