org.osgi.service.cm

Class ConfigurationEvent

java.lang.Object

org.osgi.service.cm.ConfigurationEvent

public class ConfigurationEvent
extends java.lang.Object

A Configuration Event.

ConfigurationEvent objects are delivered to all registered ConfigurationListener service objects. ConfigurationEvents must be delivered in chronological order with respect to each listener.

A type code is used to identify the type of event. The following event types are defined:

• CM_UPDATED
• CM_DELETED
• CM_LOCATION_CHANGED

Additional event types may be defined in the future.

Security Considerations. ConfigurationEvent objects do not provide Configuration objects, so no sensitive configuration information is available from the event. If the listener wants to locate the Configuration object for the specified pid, it must use ConfigurationAdmin.

Since:

1.2

Author:

$Id: d0c13bb6c11ff90250da4bcfa51cfe8891b148ba $

See Also:

ConfigurationListener

Immutable

Field Summary

Fields

Modifier and Type	Field and Description
static int	CM_DELETED A Configuration has been deleted.
static int	CM_LOCATION_CHANGED The location of a Configuration has been changed.
static int	CM_UPDATED A Configuration has been updated.

Constructor Summary

Constructors

Constructor and Description
ConfigurationEvent(ServiceReference<ConfigurationAdmin> reference, int type, java.lang.String factoryPid, java.lang.String pid) Constructs a ConfigurationEvent object from the given ServiceReference object, event type, and pids.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	getFactoryPid() Returns the factory pid of the associated configuration.
java.lang.String	getPid() Returns the pid of the associated configuration.
ServiceReference<ConfigurationAdmin>	getReference() Return the ServiceReference object of the Configuration Admin service that created this event.
int	getType() Return the type of this event.

Methods inherited from class java.lang.Object

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

Field Detail

CM_UPDATED

public static final int CM_UPDATED

A Configuration has been updated.

This ConfigurationEvent type that indicates that a Configuration object has been updated with new properties. An event is fired when a call to Configuration.update(Dictionary) successfully changes a configuration.

See Also:

Constant Field Values

CM_DELETED

public static final int CM_DELETED

A Configuration has been deleted.

This ConfigurationEvent type that indicates that a Configuration object has been deleted. An event is fired when a call to Configuration.delete() successfully deletes a configuration.

See Also:

Constant Field Values

CM_LOCATION_CHANGED

public static final int CM_LOCATION_CHANGED

The location of a Configuration has been changed.

This ConfigurationEvent type that indicates that the location of a Configuration object has been changed. An event is fired when a call to Configuration.setBundleLocation(String) successfully changes the location.

Since:

1.4

See Also:

Constant Field Values

Constructor Detail

ConfigurationEvent

public ConfigurationEvent(ServiceReference<ConfigurationAdmin> reference,
                  int type,
                  java.lang.String factoryPid,
                  java.lang.String pid)

Constructs a ConfigurationEvent object from the given ServiceReference object, event type, and pids.

Parameters:

reference - The ServiceReference object of the Configuration Admin service that created this event.

type - The event type. See getType().

factoryPid - The factory pid of the associated configuration if the target of the configuration is a ManagedServiceFactory. Otherwise null if the target of the configuration is a ManagedService.

pid - The pid of the associated configuration.

Method Detail

getFactoryPid

public java.lang.String getFactoryPid()

Returns the factory pid of the associated configuration.

Returns:

Returns the factory pid of the associated configuration if the target of the configuration is a ManagedServiceFactory. Otherwise null if the target of the configuration is a ManagedService.

getPid

public java.lang.String getPid()

Returns the pid of the associated configuration.

Returns:

Returns the pid of the associated configuration.

getType

public int getType()

Return the type of this event.

The type values are:

• CM_UPDATED
• CM_DELETED
• CM_LOCATION_CHANGED

Returns:

The type of this event.

getReference

public ServiceReference<ConfigurationAdmin> getReference()

Return the ServiceReference object of the Configuration Admin service that created this event.

Returns:

The ServiceReference object for the Configuration Admin service that created this event.