org.jivesoftware.smackx.offline

Class OfflineMessageManager

java.lang.Object

org.jivesoftware.smackx.offline.OfflineMessageManager

public class OfflineMessageManager
extends Object

The OfflineMessageManager helps manage offline messages even before the user has sent an available presence. When a user asks for his offline messages before sending an available presence then the server will not send a flood with all the offline messages when the user becomes online. The server will not send a flood with all the offline messages to the session that made the offline messages request or to any other session used by the user that becomes online.

Once the session that made the offline messages request has been closed and the user becomes offline in all the resources then the server will resume storing the messages offline and will send all the offline messages to the user when he becomes online. Therefore, the server will flood the user when he becomes online unless the user uses this class to manage his offline messages.

Constructor Summary

Constructors

Constructor and Description
OfflineMessageManager(XMPPConnection connection)

Method Summary

Methods

Modifier and Type	Method and Description
void	deleteMessages() Deletes all offline messages of the user.
void	deleteMessages(List<String> nodes) Deletes the specified list of offline messages.
List<OfflineMessageHeader>	getHeaders() Returns a List of OfflineMessageHeader that keep information about the offline message.
int	getMessageCount() Returns the number of offline messages for the user of the connection.
List<Message>	getMessages() Returns an Iterator with all the offline Messages of the user.
List<Message>	getMessages(List<String> nodes) Returns a List of the offline Messages whose stamp matches the specified request.
boolean	supportsFlexibleRetrieval() Returns true if the server supports Flexible Offline Message Retrieval.

Methods inherited from class java.lang.Object

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

Constructor Detail

OfflineMessageManager

public OfflineMessageManager(XMPPConnection connection)

Method Detail

supportsFlexibleRetrieval

public boolean supportsFlexibleRetrieval()
                                  throws SmackException.NoResponseException,
                                         XMPPException.XMPPErrorException,
                                         SmackException.NotConnectedException

Returns true if the server supports Flexible Offline Message Retrieval. When the server supports Flexible Offline Message Retrieval it is possible to get the header of the offline messages, get specific messages, delete specific messages, etc.

Returns:

a boolean indicating if the server supports Flexible Offline Message Retrieval.

Throws:

XMPPException.XMPPErrorException - If the user is not allowed to make this request.

SmackException.NoResponseException - if there was no response from the server.

SmackException.NotConnectedException

getMessageCount

public int getMessageCount()
                    throws SmackException.NoResponseException,
                           XMPPException.XMPPErrorException,
                           SmackException.NotConnectedException

Returns the number of offline messages for the user of the connection.

Returns:

the number of offline messages for the user of the connection.

Throws:

XMPPException.XMPPErrorException - If the user is not allowed to make this request or the server does not support offline message retrieval.

SmackException.NoResponseException - if there was no response from the server.

SmackException.NotConnectedException

getHeaders

public List<OfflineMessageHeader> getHeaders()
                                      throws SmackException.NoResponseException,
                                             XMPPException.XMPPErrorException,
                                             SmackException.NotConnectedException

Returns a List of OfflineMessageHeader that keep information about the offline message. The OfflineMessageHeader includes a stamp that could be used to retrieve the complete message or delete the specific message.

Returns:

a List of OfflineMessageHeader that keep information about the offline message.

Throws:

XMPPException.XMPPErrorException - If the user is not allowed to make this request or the server does not support offline message retrieval.

SmackException.NoResponseException - if there was no response from the server.

SmackException.NotConnectedException

getMessages

public List<Message> getMessages(List<String> nodes)
                          throws SmackException.NoResponseException,
                                 XMPPException.XMPPErrorException,
                                 SmackException.NotConnectedException

Returns a List of the offline Messages whose stamp matches the specified request. The request will include the list of stamps that uniquely identifies the offline messages to retrieve. The returned offline messages will not be deleted from the server. Use deleteMessages(java.util.List) to delete the messages.

Parameters:

nodes - the list of stamps that uniquely identifies offline message.

Returns:

a List with the offline Messages that were received as part of this request.

Throws:

XMPPException.XMPPErrorException - If the user is not allowed to make this request or the server does not support offline message retrieval.

SmackException.NoResponseException - if there was no response from the server.

SmackException.NotConnectedException

getMessages

public List<Message> getMessages()
                          throws SmackException.NoResponseException,
                                 XMPPException.XMPPErrorException,
                                 SmackException.NotConnectedException

Returns an Iterator with all the offline Messages of the user. The returned offline messages will not be deleted from the server. Use deleteMessages(java.util.List) to delete the messages.

Returns:

a List with all the offline Messages of the user.

Throws:

XMPPException.XMPPErrorException - If the user is not allowed to make this request or the server does not support offline message retrieval.

SmackException.NoResponseException - if there was no response from the server.

SmackException.NotConnectedException

deleteMessages

public void deleteMessages(List<String> nodes)
                    throws SmackException.NoResponseException,
                           XMPPException.XMPPErrorException,
                           SmackException.NotConnectedException

Deletes the specified list of offline messages. The request will include the list of stamps that uniquely identifies the offline messages to delete.

Parameters:

nodes - the list of stamps that uniquely identifies offline message.

Throws:

XMPPException.XMPPErrorException - If the user is not allowed to make this request or the server does not support offline message retrieval.

SmackException.NoResponseException - if there was no response from the server.

SmackException.NotConnectedException

deleteMessages

public void deleteMessages()
                    throws SmackException.NoResponseException,
                           XMPPException.XMPPErrorException,
                           SmackException.NotConnectedException

Deletes all offline messages of the user.

Throws:

XMPPException.XMPPErrorException - If the user is not allowed to make this request or the server does not support offline message retrieval.

SmackException.NoResponseException - if there was no response from the server.

SmackException.NotConnectedException