Package org.apache.aries.util.tracker.hook

Class BundleHookBundleTracker<T>

  • All Implemented Interfaces:
    org.osgi.util.tracker.BundleTrackerCustomizer
    public class BundleHookBundleTracker<T>
extends org.osgi.util.tracker.BundleTracker
    The Tracked and AbstractTracked inner classes are copied from felix framework 4.0.1.

    • Constructor Summary

      Constructors 
      Constructor Description
      BundleHookBundleTracker​(org.osgi.framework.BundleContext context, int stateMask, org.osgi.util.tracker.BundleTrackerCustomizer customizer)
      Create a BundleTracker for bundles whose state is present in the specified state mask.

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      java.lang.Object addingBundle​(org.osgi.framework.Bundle bundle, org.osgi.framework.BundleEvent event)
      Default implementation of the BundleTrackerCustomizer.addingBundle method.
      void close()
      Close this BundleTracker.
      org.osgi.framework.Bundle[] getBundles()
      Return an array of Bundles for all bundles being tracked by this BundleTracker.
      T getObject​(org.osgi.framework.Bundle bundle)
      Returns the customized object for the specified Bundle if the specified bundle is being tracked by this BundleTracker.
      java.util.Map<org.osgi.framework.Bundle,​T> getTracked()
      Return a Map with the Bundles and customized objects for all bundles being tracked by this BundleTracker.
      int getTrackingCount()
      Returns the tracking count for this BundleTracker.
      boolean isEmpty()
      Return if this BundleTracker is empty.
      void modifiedBundle​(org.osgi.framework.Bundle bundle, org.osgi.framework.BundleEvent event, java.lang.Object object)
      Default implementation of the BundleTrackerCustomizer.modifiedBundle method.
      void open()
      Open this BundleTracker and begin tracking bundles.
      void remove​(org.osgi.framework.Bundle bundle)
      Remove a bundle from this BundleTracker.
      void removedBundle​(org.osgi.framework.Bundle bundle, org.osgi.framework.BundleEvent event, java.lang.Object object)
      Default implementation of the BundleTrackerCustomizer.removedBundle method.
      int size()
      Return the number of bundles being tracked by this BundleTracker.

      • Methods inherited from class java.lang.Object

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

    • Constructor Detail

      • BundleHookBundleTracker

        public BundleHookBundleTracker​(org.osgi.framework.BundleContext context,
                               int stateMask,
                               org.osgi.util.tracker.BundleTrackerCustomizer customizer)
        Create a BundleTracker for bundles whose state is present in the specified state mask.

        Bundles whose state is present on the specified state mask will be tracked by this BundleTracker.

        Parameters:
        context - The BundleContext against which the tracking is done.
        stateMask - The bit mask of the ORing of the bundle states to be tracked.
        customizer - The customizer object to call when bundles are added, modified, or removed in this BundleTracker. If customizer is null, then this BundleTracker will be used as the BundleTrackerCustomizer and this BundleTracker will call the BundleTrackerCustomizer methods on itself.
        See Also:
        Bundle.getState()

    • Method Detail

      • open

        public void open()
        Open this BundleTracker and begin tracking bundles.

        Bundle which match the state criteria specified when this BundleTracker was created are now tracked by this BundleTracker.

        Overrides:
        open in class org.osgi.util.tracker.BundleTracker
        Throws:
        java.lang.IllegalStateException - If the BundleContext with which this BundleTracker was created is no longer valid.
        java.lang.SecurityException - If the caller and this class do not have the appropriate AdminPermission[context bundle,LISTENER], and the Java Runtime Environment supports permissions.

      • close

        public void close()
        Close this BundleTracker.

        This method should be called when this BundleTracker should end the tracking of bundles.

        This implementation calls getBundles() to get the list of tracked bundles to remove.

        Overrides:
        close in class org.osgi.util.tracker.BundleTracker

      • addingBundle

        public java.lang.Object addingBundle​(org.osgi.framework.Bundle bundle,
                                     org.osgi.framework.BundleEvent event)
        Default implementation of the BundleTrackerCustomizer.addingBundle method.

        This method is only called when this BundleTracker has been constructed with a null BundleTrackerCustomizer argument.

        This implementation simply returns the specified Bundle.

        This method can be overridden in a subclass to customize the object to be tracked for the bundle being added.

        Specified by:
        addingBundle in interface org.osgi.util.tracker.BundleTrackerCustomizer<T>
        Overrides:
        addingBundle in class org.osgi.util.tracker.BundleTracker
        Parameters:
        bundle - The Bundle being added to this BundleTracker object.
        event - The bundle event which caused this customizer method to be called or null if there is no bundle event associated with the call to this method.
        Returns:
        The specified bundle.
        See Also:
        BundleTrackerCustomizer.addingBundle(Bundle, BundleEvent)

      • modifiedBundle

        public void modifiedBundle​(org.osgi.framework.Bundle bundle,
                           org.osgi.framework.BundleEvent event,
                           java.lang.Object object)
        Default implementation of the BundleTrackerCustomizer.modifiedBundle method.

        This method is only called when this BundleTracker has been constructed with a null BundleTrackerCustomizer argument.

        This implementation does nothing.

        Specified by:
        modifiedBundle in interface org.osgi.util.tracker.BundleTrackerCustomizer<T>
        Overrides:
        modifiedBundle in class org.osgi.util.tracker.BundleTracker
        Parameters:
        bundle - The Bundle whose state has been modified.
        event - The bundle event which caused this customizer method to be called or null if there is no bundle event associated with the call to this method.
        object - The customized object for the specified Bundle.
        See Also:
        BundleTrackerCustomizer.modifiedBundle(Bundle, BundleEvent, Object)

      • removedBundle

        public void removedBundle​(org.osgi.framework.Bundle bundle,
                          org.osgi.framework.BundleEvent event,
                          java.lang.Object object)
        Default implementation of the BundleTrackerCustomizer.removedBundle method.

        This method is only called when this BundleTracker has been constructed with a null BundleTrackerCustomizer argument.

        This implementation does nothing.

        Specified by:
        removedBundle in interface org.osgi.util.tracker.BundleTrackerCustomizer<T>
        Overrides:
        removedBundle in class org.osgi.util.tracker.BundleTracker
        Parameters:
        bundle - The Bundle being removed.
        event - The bundle event which caused this customizer method to be called or null if there is no bundle event associated with the call to this method.
        object - The customized object for the specified bundle.
        See Also:
        BundleTrackerCustomizer.removedBundle(Bundle, BundleEvent, Object)

      • getBundles

        public org.osgi.framework.Bundle[] getBundles()
        Return an array of Bundles for all bundles being tracked by this BundleTracker.
        Overrides:
        getBundles in class org.osgi.util.tracker.BundleTracker
        Returns:
        An array of Bundles or null if no bundles are being tracked.

      • getObject

        public T getObject​(org.osgi.framework.Bundle bundle)
        Returns the customized object for the specified Bundle if the specified bundle is being tracked by this BundleTracker.
        Overrides:
        getObject in class org.osgi.util.tracker.BundleTracker
        Parameters:
        bundle - The Bundle being tracked.
        Returns:
        The customized object for the specified Bundle or null if the specified Bundle is not being tracked.

      • remove

        public void remove​(org.osgi.framework.Bundle bundle)
        Remove a bundle from this BundleTracker. The specified bundle will be removed from this BundleTracker . If the specified bundle was being tracked then the BundleTrackerCustomizer.removedBundle method will be called for that bundle.
        Overrides:
        remove in class org.osgi.util.tracker.BundleTracker
        Parameters:
        bundle - The Bundle to be removed.

      • size

        public int size()
        Return the number of bundles being tracked by this BundleTracker.
        Overrides:
        size in class org.osgi.util.tracker.BundleTracker
        Returns:
        The number of bundles being tracked.

      • getTrackingCount

        public int getTrackingCount()
        Returns the tracking count for this BundleTracker. The tracking count is initialized to 0 when this BundleTracker is opened. Every time a bundle is added, modified or removed from this BundleTracker the tracking count is incremented.

        The tracking count can be used to determine if this BundleTracker has added, modified or removed a bundle by comparing a tracking count value previously collected with the current tracking count value. If the value has not changed, then no bundle has been added, modified or removed from this BundleTracker since the previous tracking count was collected.

        Overrides:
        getTrackingCount in class org.osgi.util.tracker.BundleTracker
        Returns:
        The tracking count for this BundleTracker or -1 if this BundleTracker is not open.

      • getTracked

        public java.util.Map<org.osgi.framework.Bundle,​T> getTracked()
        Return a Map with the Bundles and customized objects for all bundles being tracked by this BundleTracker.
        Overrides:
        getTracked in class org.osgi.util.tracker.BundleTracker
        Returns:
        A Map with the Bundles and customized objects for all services being tracked by this BundleTracker. If no bundles are being tracked, then the returned map is empty.
        Since:
        1.5

      • isEmpty

        public boolean isEmpty()
        Return if this BundleTracker is empty.
        Overrides:
        isEmpty in class org.osgi.util.tracker.BundleTracker
        Returns:
        true if this BundleTracker is not tracking any bundles.
        Since:
        1.5