OSGi™ Service Platform
Release 4 Version 4.2

org.osgi.service.blueprint.container
Interface BlueprintListener


public interface BlueprintListener

A BlueprintEvent Listener.

To receive Blueprint Events, a bundle must register a Blueprint Listener service. After a Blueprint Listener is registered, the Blueprint extender must synchronously send to this Blueprint Listener the last Blueprint Event for each ready Blueprint bundle managed by this extender. This replay of Blueprint Events is designed so that the new Blueprint Listener can be informed of the state of each Blueprint bundle. Blueprint Events sent during this replay will have the isReplay() flag set. The Blueprint extender must ensure that this replay phase does not interfere with new Blueprint Events so that the chronological order of all Blueprint Events received by the Blueprint Listener is preserved. If the last Blueprint Event for a given Blueprint bundle is DESTROYED, the extender must not send it during this replay phase.

See Also:
BlueprintEvent
ThreadSafe

Method Summary
 void blueprintEvent(BlueprintEvent event)
          Receives notifications of a Blueprint Event.
 

Method Detail

blueprintEvent

void blueprintEvent(BlueprintEvent event)
Receives notifications of a Blueprint Event. Implementers should quickly process the event and return.

Parameters:
event - The BlueprintEvent.

OSGi™ Service Platform
Release 4 Version 4.2

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