org.opendaylight.controller.config.manager.impl.osgi

Class ExtensibleBundleTracker<T>

java.lang.Object

org.osgi.util.tracker.BundleTracker<Future<T>>

org.opendaylight.controller.config.manager.impl.osgi.ExtensibleBundleTracker<T>

Type Parameters:

T - value

All Implemented Interfaces:

org.osgi.util.tracker.BundleTrackerCustomizer<Future<T>>

public final class ExtensibleBundleTracker<T>
extends org.osgi.util.tracker.BundleTracker<Future<T>>

Extensible bundle tracker. Takes several BundleTrackerCustomizers and propagates bundle events to all of them.

Primary customizer may return tracking object, which will be passed to it during invocation of BundleTrackerCustomizer.removedBundle(Bundle, BundleEvent, Object)

This extender modifies behavior to not leak platform thread in BundleTrackerCustomizer.addingBundle(Bundle, BundleEvent) but deliver this event from its own single threaded executor.

If bundle is removed before event for adding bundle was executed, that event is cancelled. If addingBundle event is currently in progress or was already executed, platform thread is block until addingBundle finishes so bundle could be removed correctly in platform thread.

Method BundleTrackerCustomizer.removedBundle(Bundle, BundleEvent, Object) is never invoked on registered trackers.

Field Summary

Fields inherited from class org.osgi.util.tracker.BundleTracker

context

Constructor Summary

Constructors

Constructor and Description
ExtensibleBundleTracker(org.osgi.framework.BundleContext context, org.osgi.util.tracker.BundleTrackerCustomizer<T> primaryBundleTrackerCustomizer, org.osgi.util.tracker.BundleTrackerCustomizer<?>... additionalBundleTrackerCustomizers)
ExtensibleBundleTracker(org.osgi.framework.BundleContext context, int bundleState, org.osgi.util.tracker.BundleTrackerCustomizer<T> primaryBundleTrackerCustomizer, org.osgi.util.tracker.BundleTrackerCustomizer<?>... additionalBundleTrackerCustomizers)

Method Summary

Modifier and Type	Method and Description
Future<T>	addingBundle(org.osgi.framework.Bundle bundle, org.osgi.framework.BundleEvent event)
void	modifiedBundle(org.osgi.framework.Bundle bundle, org.osgi.framework.BundleEvent event, Future<T> object)
void	removedBundle(org.osgi.framework.Bundle bundle, org.osgi.framework.BundleEvent event, Future<T> object)

Methods inherited from class org.osgi.util.tracker.BundleTracker

close, getBundles, getObject, getTracked, getTrackingCount, isEmpty, open, remove, size

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ExtensibleBundleTracker

public ExtensibleBundleTracker(org.osgi.framework.BundleContext context,
                               org.osgi.util.tracker.BundleTrackerCustomizer<T> primaryBundleTrackerCustomizer,
                               org.osgi.util.tracker.BundleTrackerCustomizer<?>... additionalBundleTrackerCustomizers)

ExtensibleBundleTracker

public ExtensibleBundleTracker(org.osgi.framework.BundleContext context,
                               int bundleState,
                               org.osgi.util.tracker.BundleTrackerCustomizer<T> primaryBundleTrackerCustomizer,
                               org.osgi.util.tracker.BundleTrackerCustomizer<?>... additionalBundleTrackerCustomizers)

Method Detail

addingBundle

public Future<T> addingBundle(org.osgi.framework.Bundle bundle,
                              org.osgi.framework.BundleEvent event)

Specified by:

addingBundle in interface org.osgi.util.tracker.BundleTrackerCustomizer<Future<T>>

Overrides:

addingBundle in class org.osgi.util.tracker.BundleTracker<Future<T>>

modifiedBundle

public void modifiedBundle(org.osgi.framework.Bundle bundle,
                           org.osgi.framework.BundleEvent event,
                           Future<T> object)

Specified by:

modifiedBundle in interface org.osgi.util.tracker.BundleTrackerCustomizer<Future<T>>

Overrides:

modifiedBundle in class org.osgi.util.tracker.BundleTracker<Future<T>>

removedBundle

public void removedBundle(org.osgi.framework.Bundle bundle,
                          org.osgi.framework.BundleEvent event,
                          Future<T> object)

Specified by:

removedBundle in interface org.osgi.util.tracker.BundleTrackerCustomizer<Future<T>>

Overrides:

removedBundle in class org.osgi.util.tracker.BundleTracker<Future<T>>