Interface SynchronousBundleListener
-
- All Superinterfaces:
BundleListener
,java.util.EventListener
- Functional Interface:
- This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
@ConsumerType @FunctionalInterface public interface SynchronousBundleListener extends BundleListener
A synchronousBundleEvent
listener.SynchronousBundleListener
is a listener interface that may be implemented by a bundle developer. When aBundleEvent
is fired, it is synchronously delivered to aSynchronousBundleListener
. The Framework may deliverBundleEvent
objects to aSynchronousBundleListener
out of order and may concurrently call and/or reenter aSynchronousBundleListener
.For
BundleEvent
typesSTARTED
andLAZY_ACTIVATION
, the Framework must not hold the referenced bundle's "state change" lock when theBundleEvent
is delivered to aSynchronousBundleListener
. For the otherBundleEvent
types, the Framework must hold the referenced bundle's "state change" lock when theBundleEvent
is delivered to aSynchronousBundleListener
. ASynchronousBundleListener
cannot directly call life cycle methods on the referenced bundle when the Framework is holding the referenced bundle's "state change" lock.A
SynchronousBundleListener
object is registered with the Framework using theBundleContext.addBundleListener(BundleListener)
method.SynchronousBundleListener
objects are called with aBundleEvent
object when a bundle has been installed, resolved, starting, started, stopping, stopped, updated, unresolved, or uninstalled.Unlike normal
BundleListener
objects,SynchronousBundleListener
s are synchronously called during bundle lifecycle processing. The bundle lifecycle processing will not proceed until allSynchronousBundleListener
s have completed.SynchronousBundleListener
objects will be called prior toBundleListener
objects.AdminPermission[bundle,LISTENER]
is required to add or remove aSynchronousBundleListener
object.- Since:
- 1.1
- See Also:
BundleEvent
-
-
Method Summary
-
Methods inherited from interface org.osgi.framework.BundleListener
bundleChanged
-
-