org.osgi.framework
public interface ServiceListener extends java.util.EventListener
ServiceEvent
listener. When a ServiceEvent
is
fired, it is synchronously delivered to a BundleListener
.
ServiceListener
is a listener interface that may be
implemented by a bundle developer.
A ServiceListener
object is registered with the Framework
using the BundleContext.addServiceListener
method.
ServiceListener
objects are called with a
ServiceEvent
object when a service is registered, modified, or
is in the process of unregistering.
ServiceEvent
object delivery to ServiceListener
objects is filtered by the filter specified when the listener was registered.
If the Java Runtime Environment supports permissions, then additional
filtering is done. ServiceEvent
objects are only delivered to
the listener if the bundle which defines the listener object's class has the
appropriate ServicePermission
to get the service using at
least one of the named classes the service was registered under.
ServiceEvent
object delivery to ServiceListener
objects is further filtered according to package sources as defined in
ServiceReference.isAssignableTo(Bundle, String)
.
ServiceEvent
,
ServicePermission
Modifier and Type | Method and Description |
---|---|
void |
serviceChanged(ServiceEvent event)
Receives notification that a service has had a lifecycle change.
|
void serviceChanged(ServiceEvent event)
event
- The ServiceEvent
object.