public class ConfigurationEvent extends Object
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:
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
.
ConfigurationListener
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 and Description |
---|
ConfigurationEvent(ServiceReference<ConfigurationAdmin> reference,
int type,
String factoryPid,
String pid)
Constructs a
ConfigurationEvent object from the given
ServiceReference object, event type, and pids. |
Modifier and Type | Method and Description |
---|---|
String |
getFactoryPid()
Returns the factory pid of the associated configuration.
|
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.
|
public static final int CM_UPDATED
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.
public static final int CM_DELETED
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.
public static final int CM_LOCATION_CHANGED
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.
public ConfigurationEvent(ServiceReference<ConfigurationAdmin> reference, int type, String factoryPid, String pid)
ConfigurationEvent
object from the given
ServiceReference
object, event type, and pids.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.public String getFactoryPid()
null
if the target of the configuration is a
ManagedService.public String getPid()
public int getType()
The type values are:
public ServiceReference<ConfigurationAdmin> getReference()
ServiceReference
object of the Configuration Admin
service that created this event.ServiceReference
object for the Configuration Admin
service that created this event.Copyright © Contributors to the Eclipse Foundation Licensed under the Eclipse Foundation Specification License – v1.0