org.jivesoftware.smackx.jiveproperties.packet

Class JivePropertiesExtension

java.lang.Object

org.jivesoftware.smackx.jiveproperties.packet.JivePropertiesExtension

All Implemented Interfaces:

Element, ExtensionElement, NamedElement

public class JivePropertiesExtension
extends Object
implements ExtensionElement

Properties provide an easy mechanism for clients to share data. Each property has a String name, and a value that is a Java primitive (int, long, float, double, boolean) or any Serializable object (a Java object is Serializable when it implements the Serializable interface).

Field Summary

Fields

Modifier and Type	Field and Description
static String	ELEMENT
static String	NAMESPACE Namespace used to store stanza properties.

Constructor Summary

Constructors

Constructor and Description
JivePropertiesExtension()
JivePropertiesExtension(Map<String,Object> properties)

Method Summary

Modifier and Type	Method and Description
void	deleteProperty(String name) Deletes a property.
static JivePropertiesExtension	from(Message message) Return a Jive properties extensions of the given message.
String	getElementName() Returns the root element name.
String	getNamespace() Returns the root element XML namespace.
Map<String,Object>	getProperties() Returns an unmodifiable map of all properties.
Object	getProperty(String name) Returns the stanza property with the specified name or null if the property doesn't exist.
Collection<String>	getPropertyNames() Returns an unmodifiable collection of all the property names that are set.
void	setProperty(String name, Object value) Sets a property with an Object as the value.
CharSequence	toXML(String enclosingNamespace) Returns the XML representation of this Element.

Methods inherited from class java.lang.Object

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

Field Detail

NAMESPACE

public static final String NAMESPACE

Namespace used to store stanza properties.

See Also:

Constant Field Values

ELEMENT

public static final String ELEMENT

See Also:

Constant Field Values

Constructor Detail

JivePropertiesExtension

public JivePropertiesExtension()

JivePropertiesExtension

public JivePropertiesExtension(Map<String,Object> properties)

Method Detail

getProperty

public Object getProperty(String name)

Returns the stanza property with the specified name or null if the property doesn't exist. Property values that were originally primitives will be returned as their object equivalent. For example, an int property will be returned as an Integer, a double as a Double, etc.

Parameters:

name - the name of the property.

Returns:

the property, or null if the property doesn't exist.

setProperty

public void setProperty(String name,
                        Object value)

Sets a property with an Object as the value. The value must be Serializable or an IllegalArgumentException will be thrown.

Parameters:

name - the name of the property.

value - the value of the property.

deleteProperty

public void deleteProperty(String name)

Deletes a property.

Parameters:

name - the name of the property to delete.

getPropertyNames

public Collection<String> getPropertyNames()

Returns an unmodifiable collection of all the property names that are set.

Returns:

all property names.

getProperties

public Map<String,Object> getProperties()

Returns an unmodifiable map of all properties.

Returns:

all properties.

getElementName

public String getElementName()

Description copied from interface: NamedElement

Returns the root element name.

Specified by:

getElementName in interface NamedElement

Returns:

the element name.

getNamespace

public String getNamespace()

Description copied from interface: ExtensionElement

Returns the root element XML namespace.

Specified by:

getNamespace in interface ExtensionElement

Returns:

the namespace.

toXML

public CharSequence toXML(String enclosingNamespace)

Description copied from interface: Element

Returns the XML representation of this Element. This method takes an optional argument for the enclosing namespace which may be null or the empty String if the value is not known.

Specified by:

toXML in interface Element

Parameters:

enclosingNamespace - the enclosing namespace or null.

Returns:

the stanza extension as XML.

from

public static JivePropertiesExtension from(Message message)

Return a Jive properties extensions of the given message.

Parameters:

message - the message to return the extension from.

Returns:

a Jive properties extension or null.

Since:

4.2