mirror of
https://codeberg.org/Mercury-IM/Smack
synced 2024-11-26 00:02:06 +01:00
Javadoc improvements.
git-svn-id: http://svn.igniterealtime.org/svn/repos/smack/trunk@2048 b35dd754-fafc-0310-a699-88a17e54d16e
This commit is contained in:
parent
f6676a616f
commit
83275fa888
1 changed files with 24 additions and 7 deletions
|
@ -71,10 +71,11 @@ import java.util.Hashtable;
|
|||
*/
|
||||
public class PrivateDataManager {
|
||||
|
||||
/**
|
||||
* Map of provider instances.
|
||||
*/
|
||||
private static Map privateDataProviders = new Hashtable();
|
||||
|
||||
private XMPPConnection con;
|
||||
|
||||
/**
|
||||
* Returns the private data provider registered to the specified XML element name and namespace.
|
||||
* For example, if a provider was registered to the element name "prefs" and the
|
||||
|
@ -117,6 +118,9 @@ public class PrivateDataManager {
|
|||
privateDataProviders.put(key, provider);
|
||||
}
|
||||
|
||||
|
||||
private XMPPConnection con;
|
||||
|
||||
/**
|
||||
* Creates a new private data manager.
|
||||
*
|
||||
|
@ -127,12 +131,17 @@ public class PrivateDataManager {
|
|||
}
|
||||
|
||||
/**
|
||||
* Returns the private data specified by the given element name and namespace.
|
||||
* Returns the private data specified by the given element name and namespace. Each chunk
|
||||
* of private data is uniquely identified by an element name and namespace pair.<p>
|
||||
*
|
||||
* If a PrivateDataProvider is registered for the specified element name/namespace pair then
|
||||
* that provider will determine the specific object type that is returned. If no provider
|
||||
* is registered, a {@link DefaultPrivateData} instance will be returned.
|
||||
*
|
||||
* @param elementName the element name.
|
||||
* @param namespace the namespace.
|
||||
* @return the private data.
|
||||
* @throws XMPPException
|
||||
* @throws XMPPException if an error occurs getting the private data.
|
||||
*/
|
||||
public PrivateData getPrivateData(final String elementName, final String namespace)
|
||||
throws XMPPException
|
||||
|
@ -168,6 +177,14 @@ public class PrivateDataManager {
|
|||
return ((PrivateDataResult)response).getPrivateData();
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets a private data value. Each chunk of private data is uniquely identified by an
|
||||
* element name and namespace pair. If private data has already been set with the
|
||||
* element name and namespace, then the new private data will overwrite the old value.
|
||||
*
|
||||
* @param privateData the private data.
|
||||
* @throws XMPPException if setting the private data fails.
|
||||
*/
|
||||
public void setPrivateData(final PrivateData privateData) throws XMPPException {
|
||||
// Create an IQ packet to set the private data.
|
||||
IQ privateDataSet = new IQ() {
|
||||
|
@ -278,8 +295,8 @@ public class PrivateDataManager {
|
|||
}
|
||||
}
|
||||
|
||||
private static PrivateData parseWithIntrospection(String elementName,
|
||||
Class objectClass, XmlPullParser parser) throws Exception
|
||||
private static PrivateData parseWithIntrospection(String elementName, Class objectClass,
|
||||
XmlPullParser parser) throws Exception
|
||||
{
|
||||
boolean done = false;
|
||||
PrivateData object = (PrivateData)objectClass.newInstance();
|
||||
|
@ -364,4 +381,4 @@ public class PrivateDataManager {
|
|||
return buf.toString();
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
Loading…
Reference in a new issue