org.jivesoftware.smack

Class SynchronizationPoint<E extends java.lang.Exception>

java.lang.Object

org.jivesoftware.smack.SynchronizationPoint<E>

public class SynchronizationPoint<E extends java.lang.Exception>
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
SynchronizationPoint(AbstractXMPPConnection connection, java.lang.String waitFor) Construct a new synchronization point for the given connection.

Method Summary

Modifier and Type	Method and Description
E	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.
E	sendAndWaitForResponse(TopLevelStreamElement request) Send the given top level stream element and wait for a response.
void	sendAndWaitForResponseOrThrow(Nonza 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,
                            java.lang.String waitFor)

Construct a new synchronization point for the given connection.

Parameters:

connection - the connection of this synchronization point.

waitFor - a description of the event this synchronization point handles.

Method Detail

init

public void init()

Initialize (or reset) this synchronization point.

sendAndWaitForResponse

public E sendAndWaitForResponse(TopLevelStreamElement request)
                         throws SmackException.NoResponseException,
                                SmackException.NotConnectedException,
                                java.lang.InterruptedException

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

Parameters:

request - the plain stream element to send.

Returns:

null if synchronization point was successful, or the failure Exception.

Throws:

SmackException.NoResponseException - if no response was received.

SmackException.NotConnectedException - if the connection is not connected.

java.lang.InterruptedException

sendAndWaitForResponseOrThrow

public void sendAndWaitForResponseOrThrow(Nonza request)
                                   throws E extends java.lang.Exception,
                                          SmackException.NoResponseException,
                                          SmackException.NotConnectedException,
                                          java.lang.InterruptedException

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 java.lang.Exception

java.lang.InterruptedException

checkIfSuccessOrWaitOrThrow

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

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

java.lang.InterruptedException

E extends java.lang.Exception

checkIfSuccessOrWait

public E checkIfSuccessOrWait()
                       throws SmackException.NoResponseException,
                              java.lang.InterruptedException

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

Returns:

null if synchronization point was successful, or the failure Exception.

Throws:

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

java.lang.InterruptedException

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.