org.jivesoftware.smackx.jiveproperties

Class JivePropertiesManager

java.lang.Object

org.jivesoftware.smackx.jiveproperties.JivePropertiesManager

public class JivePropertiesManager
extends Object

Constructor Summary

Constructors

Constructor and Description
JivePropertiesManager()

Method Summary

Modifier and Type	Method and Description
static void	addProperty(Stanza packet, String name, Object value) Convenience method to add a property to a packet.
static Map<String,Object>	getProperties(Stanza packet) Return a map of all properties of the given packet.
static Collection<String>	getPropertiesNames(Stanza packet) Return a collection of the names of all properties of the given packet.
static Object	getProperty(Stanza packet, String name) Convenience method to get a property from a packet.
static boolean	isJavaObjectEnabled()
static void	setJavaObjectEnabled(boolean enabled) Enables deserialization of Java objects embedded in the 'properties' stanza(/packet) extension.

Methods inherited from class java.lang.Object

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

Constructor Detail

JivePropertiesManager

public JivePropertiesManager()

Method Detail

setJavaObjectEnabled

public static void setJavaObjectEnabled(boolean enabled)

Enables deserialization of Java objects embedded in the 'properties' stanza(/packet) extension. Since this is a security sensitive feature, it is disabled per default in Smack. Only enable it if you are sure that you understand the potential security implications it can cause.

See also:

• "What is the security impact of deserializing untrusted data in Java?" on Stackoverflow

Parameters:

enabled - true to enable Java object deserialization

isJavaObjectEnabled

public static boolean isJavaObjectEnabled()

addProperty

public static void addProperty(Stanza packet,
                               String name,
                               Object value)

Convenience method to add a property to a packet.

Parameters:

packet - the stanza(/packet) to add the property to.

name - the name of the property to add.

value - the value of the property to add.

getProperty

public static Object getProperty(Stanza packet,
                                 String name)

Convenience method to get a property from a packet. Will return null if the stanza(/packet) contains not property with the given name.

Parameters:

packet -

name -

Returns:

the property or null if none found.

getPropertiesNames

public static Collection<String> getPropertiesNames(Stanza packet)

Return a collection of the names of all properties of the given packet. If the packet contains no properties extension, then an empty collection will be returned.

Parameters:

packet -

Returns:

a collection of the names of all properties.

getProperties

public static Map<String,Object> getProperties(Stanza packet)

Return a map of all properties of the given packet. If the stanza(/packet) contains no properties extension, an empty map will be returned.

Parameters:

packet -

Returns:

a map of all properties of the given packet.