org.osgi.service.event

Class EventProperties

java.lang.Object

org.osgi.service.event.EventProperties

All Implemented Interfaces:

Map<String,Object>

public class EventProperties
extends Object
implements Map<String,Object>

The properties for an Event. An event source can create an EventProperties object if it needs to reuse the same event properties for multiple events.

The keys are all of type String. The values are of type Object. The key "event.topics" is ignored as event topics can only be set when an Event is constructed.

Once constructed, an EventProperties object is unmodifiable. However, the values of the map used to construct an EventProperties object are still subject to modification as they are not deeply copied.

Since:

1.3

"Immutable"

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Constructor Summary

Constructors

Constructor and Description
EventProperties(Map<String,?> properties) Create an EventProperties from the specified properties.

Method Summary

Methods

Modifier and Type	Method and Description
void	clear() This method throws UnsupportedOperationException.
boolean	containsKey(Object name) Indicates if the specified property is present.
boolean	containsValue(Object value) Indicates if the specified value is present.
Set<Map.Entry<String,Object>>	entrySet() Return the property entries.
boolean	equals(Object object) Compares this EventProperties object to another object.
Object	get(Object name) Return the value of the specified property.
int	hashCode() Returns a hash code value for this object.
boolean	isEmpty() Indicate if this properties is empty.
Set<String>	keySet() Return the names of the properties.
Object	put(String key, Object value) This method throws UnsupportedOperationException.
void	putAll(Map<? extends String,? extends Object> map) This method throws UnsupportedOperationException.
Object	remove(Object key) This method throws UnsupportedOperationException.
int	size() Return the number of properties.
String	toString() Returns the string representation of this object.
Collection<Object>	values() Return the properties values.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

EventProperties

public EventProperties(Map<String,?> properties)

Create an EventProperties from the specified properties.

The specified properties will be copied into this EventProperties. Properties whose key is not of type String will be ignored. A property with the key "event.topics" will be ignored.

Parameters:

properties - The properties to use for this EventProperties object (may be null).

Method Detail

clear

public void clear()

This method throws UnsupportedOperationException.

Specified by:

clear in interface Map<String,Object>

Throws:

UnsupportedOperationException - if called.

containsKey

public boolean containsKey(Object name)

Indicates if the specified property is present.

Specified by:

containsKey in interface Map<String,Object>

Parameters:

name - The property name.

Returns:

true If the property is present, false otherwise.

containsValue

public boolean containsValue(Object value)

Indicates if the specified value is present.

Specified by:

containsValue in interface Map<String,Object>

Parameters:

value - The property value.

Returns:

true If the value is present, false otherwise.

entrySet

public Set<Map.Entry<String,Object>> entrySet()

Return the property entries.

Specified by:

entrySet in interface Map<String,Object>

Returns:

A set containing the property name/value pairs.

get

public Object get(Object name)

Return the value of the specified property.

Specified by:

get in interface Map<String,Object>

Parameters:

name - The name of the specified property.

Returns:

The value of the specified property.

isEmpty

public boolean isEmpty()

Indicate if this properties is empty.

Specified by:

isEmpty in interface Map<String,Object>

Returns:

true If this properties is empty, false otherwise.

keySet

public Set<String> keySet()

Return the names of the properties.

Specified by:

keySet in interface Map<String,Object>

Returns:

The names of the properties.

put

public Object put(String key,
         Object value)

This method throws UnsupportedOperationException.

Specified by:

put in interface Map<String,Object>

Throws:

UnsupportedOperationException - if called.

putAll

public void putAll(Map<? extends String,? extends Object> map)

This method throws UnsupportedOperationException.

Specified by:

putAll in interface Map<String,Object>

Throws:

UnsupportedOperationException - if called.

remove

public Object remove(Object key)

This method throws UnsupportedOperationException.

Specified by:

remove in interface Map<String,Object>

Throws:

UnsupportedOperationException - if called.

size

public int size()

Return the number of properties.

Specified by:

size in interface Map<String,Object>

Returns:

The number of properties.

values

public Collection<Object> values()

Return the properties values.

Specified by:

values in interface Map<String,Object>

Returns:

The values of the properties.

equals

public boolean equals(Object object)

Compares this EventProperties object to another object.

The properties are compared using the java.util.Map.equals() rules which includes identity comparison for array values.

Specified by:

equals in interface Map<String,Object>

Overrides:

equals in class Object

Parameters:

object - The EventProperties object to be compared.

Returns:

true if object is a EventProperties and is equal to this object; false otherwise.

hashCode

public int hashCode()

Returns a hash code value for this object.

Specified by:

hashCode in interface Map<String,Object>

Overrides:

hashCode in class Object

Returns:

An integer which is a hash code value for this object.

toString

public String toString()

Returns the string representation of this object.

Overrides:

toString in class Object

Returns:

The string representation of this object.