org.apache.aries.util.tracker

Class RecursiveBundleTracker

java.lang.Object

org.apache.aries.util.tracker.RecursiveBundleTracker

public final class RecursiveBundleTracker
extends java.lang.Object

This class supports the tracking of composite bundles. It allows clients to ignore any events related to framework bundles, as it will automatically handle these events. In order to use this class clients must create a subclass and implement the methods of the BundleTrackerCustomizer interface. In spite of this, instances of this class MUST NOT be passed as a parameter to any BundleTracker.

The model for using this is that classes should instantiate it and pass it a 'vanilla' bundle tracker.

Constructor Summary

Constructors

Constructor and Description
RecursiveBundleTracker(BundleContext context, int stateMask, BundleTrackerCustomizer customizer) Constructor

Method Summary

Modifier and Type	Method and Description
void	close() Stop the tracking of bundles
void	open() Start tracking bundles that match the bit mask provided at creation time.

Methods inherited from class java.lang.Object

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

Constructor Detail

RecursiveBundleTracker

public RecursiveBundleTracker(BundleContext context,
                              int stateMask,
                              BundleTrackerCustomizer customizer)

Constructor

Parameters:

context - - The BundleContext against which the tracking is done.

stateMask - - The bit mask of the ORing of the bundle states to be tracked. The mask must contain the flags Bundle.INSTALLED | Bundle.RESOLVED | Bundle.STARTING | Bundle.ACTIVE | Bundle.STOPPING as a minimum.

Throws:

java.lang.IllegalArgumentException - - If the provided bit mask does not contain required flags

Method Detail

open

public void open()

Start tracking bundles that match the bit mask provided at creation time.

See Also:

BundleTracker#open()

close

public void close()

Stop the tracking of bundles

See Also:

BundleTracker#close()