rocks.xmpp.extensions.privatedata

Class PrivateDataManager

java.lang.Object

rocks.xmpp.core.session.Manager

rocks.xmpp.core.session.ExtensionManager

rocks.xmpp.extensions.privatedata.PrivateDataManager

public final class PrivateDataManager
extends ExtensionManager

This class implements XEP-0049: Private XML Storage.

It allows to retrieve and store private data in the server's private XML storage.

This class is thread-safe.

Method Summary

Modifier and Type	Method and Description
<T> T	getData(Class<T> type) Gets private data, which is stored on the server.
void	storeData(Object privateData) Stores private data.

Methods inherited from class rocks.xmpp.core.session.ExtensionManager

isEnabled, setEnabled

Methods inherited from class java.lang.Object

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

Method Detail

getData

public final <T> T getData(Class<T> type)
                    throws XmppException

Gets private data, which is stored on the server.

Type Parameters:

T - The type of private data.

Parameters:

type - The class of the private data. Note that this class needs a no-arg default constructor.

Returns:

The list of stored items of the given type.

Throws:

StanzaException - If the server returned an error, e.g. if the used namespace is reserved.

NoResponseException - If the entity did not respond.

XmppException

storeData

public final void storeData(Object privateData)
                     throws XmppException

Stores private data.

Parameters:

privateData - The private data. The class of this object must be annotated with JAXB annotations and must known to the XMPP context in order to marshal und unmarshal it.

Throws:

StanzaException - If the entity returned a stanza error.

NoResponseException - If the entity did not respond.

XmppException