OSGi™ Service Platform
Release 4 Version 4.1

org.osgi.framework
Interface ServiceListener

All Superinterfaces:
java.util.EventListener
All Known Subinterfaces:
AllServiceListener

public interface ServiceListener
extends java.util.EventListener

A ServiceEvent listener. ServiceListener is a listener interface that may be implemented by a bundle developer. When a ServiceEvent is fired, it is synchronously delivered to a ServiceListener. The Framework may deliver ServiceEvent objects to a ServiceListener out of order and may concurrently call and/or reenter a ServiceListener.

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 under which the service was registered.

ServiceEvent object delivery to ServiceListener objects is further filtered according to package sources as defined in ServiceReference.isAssignableTo(Bundle, String).

See Also:
ServiceEvent, ServicePermission
ThreadSafe

Method Summary
 void serviceChanged(ServiceEvent event)
          Receives notification that a service has had a lifecycle change.
 

Method Detail

serviceChanged

public void serviceChanged(ServiceEvent event)
Receives notification that a service has had a lifecycle change.

Parameters:
event - The ServiceEvent object.

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