org.jivesoftware.smackx.jiveproperties

Class JivePropertiesManager

java.lang.Object

org.jivesoftware.smackx.jiveproperties.JivePropertiesManager

public class JivePropertiesManager
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
JivePropertiesManager()

Method Summary

Methods

Modifier and Type	Method and Description
static void	addProperty(Packet packet, java.lang.String name, java.lang.Object value) Convenience method to add a property to a packet.
static java.util.Map<java.lang.String,java.lang.Object>	getProperties(Packet packet) Return a map of all properties of the given packet.
static java.util.Collection<java.lang.String>	getPropertiesNames(Packet packet) Return a collection of the names of all properties of the given packet.
static java.lang.Object	getProperty(Packet packet, java.lang.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' 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' 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(Packet packet,
               java.lang.String name,
               java.lang.Object value)

Convenience method to add a property to a packet.

Parameters:

packet - the 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 java.lang.Object getProperty(Packet packet,
                           java.lang.String name)

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

Parameters:

packet -

name -

Returns:

the property or null if none found.

getPropertiesNames

public static java.util.Collection<java.lang.String> getPropertiesNames(Packet 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 java.util.Map<java.lang.String,java.lang.Object> getProperties(Packet packet)

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

Parameters:

packet -

Returns:

a map of all properties of the given packet.