OSGi™ Service Platform
Release 4

Interface AllServiceListener

All Superinterfaces:
java.util.EventListener, ServiceListener

public interface AllServiceListener
extends ServiceListener

A ServiceEvent listener.

AllServiceListener is a listener interface that may be implemented by a bundle developer.

An AllServiceListener object is registered with the Framework using the BundleContext.addServiceListener method. AllServiceListener objects are called with a ServiceEvent object when a service is registered, modified, or is in the process of unregistering.

ServiceEvent object delivery to AllServiceListener 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.

Unlike normal ServiceListener objects, AllServiceListener objects receive all ServiceEvent objects regardless of the whether the package source of the listening bundle is equal to the package source of the bundle that registered the service. This means that the listener may not be able to cast the service object to any of its corresponding service interfaces if the service object is retrieved.

See Also:
ServiceEvent, ServicePermission

Methods inherited from interface org.osgi.framework.ServiceListener

OSGi™ Service Platform
Release 4

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