OSGi™ Service Platform
Release 4 Version 4.1

org.osgi.service.event
Class Event

java.lang.Object
  extended byorg.osgi.service.event.Event

public class Event
extends java.lang.Object

An event. Event objects are delivered to EventHandler services which subsrcibe to the topic of the event.


Constructor Summary
Event(java.lang.String topic, java.util.Dictionary properties)
          Constructs an event.
 
Method Summary
 boolean equals(java.lang.Object object)
          Compares this Event object to another object.
 java.lang.Object getProperty(java.lang.String name)
          Retrieves a property.
 java.lang.String[] getPropertyNames()
          Returns a list of this event's property names.
 java.lang.String getTopic()
          Returns the topic of this event.
 int hashCode()
          Returns a hash code value for the object.
 boolean matches(Filter filter)
          Tests this event's properties against the given filter.
 java.lang.String toString()
          Returns the string representation of this event.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

Event

public Event(java.lang.String topic,
             java.util.Dictionary properties)
Constructs an event.

Parameters:
topic - The topic of the event.
properties - The event's properties (may be null).
Throws:
java.lang.IllegalArgumentException - If topic is not a valid topic name.
Method Detail

getProperty

public final java.lang.Object getProperty(java.lang.String name)
Retrieves a property.

Parameters:
name - the name of the property to retrieve
Returns:
The value of the property, or null if not found.

getPropertyNames

public final java.lang.String[] getPropertyNames()
Returns a list of this event's property names.

Returns:
A non-empty array with one element per property.

getTopic

public final java.lang.String getTopic()
Returns the topic of this event.

Returns:
The topic of this event.

matches

public final boolean matches(Filter filter)
Tests this event's properties against the given filter.

Parameters:
filter - The filter to test.
Returns:
true If this event's properties match the filter, false otherwise.

equals

public boolean equals(java.lang.Object object)
Compares this Event object to another object.

An event is considered to be equal to another event if the topic is equal and the properties are equal.

Parameters:
object - The Event object to be compared.
Returns:
true if object is a Event and is equal to this object; false otherwise.

hashCode

public int hashCode()
Returns a hash code value for the object.

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

toString

public java.lang.String toString()
Returns the string representation of this event.

Returns:
The string representation of this event.

OSGi™ Service Platform
Release 4 Version 4.1

Copyright © OSGi Alliance (2000, 2007). All Rights Reserved. Licensed under the OSGi Specification License, Version 1.0