Class AbstractExtender

java.lang.Object
org.apache.felix.scr.impl.AbstractExtender
All Implemented Interfaces:
EventListener, org.osgi.framework.BundleActivator, org.osgi.framework.BundleListener, org.osgi.framework.SynchronousBundleListener, org.osgi.util.tracker.BundleTrackerCustomizer<org.osgi.framework.Bundle>
Direct Known Subclasses:
Activator
public abstract class AbstractExtender extends Object implements org.osgi.framework.BundleActivator, org.osgi.util.tracker.BundleTrackerCustomizer<org.osgi.framework.Bundle>, org.osgi.framework.SynchronousBundleListener
Base class to write bundle extenders. This extender tracks started bundles (or starting if they have a lazy activation policy) and will create an extension for each of them to manage it. The extender will handle all concurrency and synchronization issues. The extender guarantee that all extensions will be stopped synchronously with the STOPPING event of a given bundle and that all extensions will be stopped before the extender bundle is stopped.

  • Field Details

    • extensions

      private final ConcurrentMap<org.osgi.framework.Bundle, Activator.ScrExtension> extensions

    • destroying

      private final ConcurrentMap<org.osgi.framework.Bundle, FutureTask<Void>> destroying

    • stopping

      private volatile boolean stopping

    • stopped

      private volatile boolean stopped

    • context

      private org.osgi.framework.BundleContext context

    • tracker

      private org.osgi.util.tracker.BundleTracker<org.osgi.framework.Bundle> tracker

  • Constructor Details

    • AbstractExtender

      public AbstractExtender()

  • Method Details

    • getBundleContext

      public org.osgi.framework.BundleContext getBundleContext()

    • isStopping

      public boolean isStopping()

    • start

      public void start(org.osgi.framework.BundleContext context) throws Exception
      Specified by:
      start in interface org.osgi.framework.BundleActivator
      Throws:
      Exception

    • stop

      public void stop(org.osgi.framework.BundleContext context) throws Exception
      Specified by:
      stop in interface org.osgi.framework.BundleActivator
      Throws:
      Exception

    • doStart

      protected void doStart() throws Exception
      Throws:
      Exception

    • doStop

      protected void doStop() throws Exception
      Throws:
      Exception

    • startTracking

      protected void startTracking()

    • stopTracking

      protected void stopTracking()

    • createExecutor

      protected ExecutorService createExecutor()
      Create the executor used to start extensions asynchronously.
      Returns:
      an

    • chooseBundlesToDestroy

      protected Collection<org.osgi.framework.Bundle> chooseBundlesToDestroy(Set<org.osgi.framework.Bundle> bundles)

    • bundleChanged

      public void bundleChanged(org.osgi.framework.BundleEvent event)
      Specified by:
      bundleChanged in interface org.osgi.framework.BundleListener

    • addingBundle

      public org.osgi.framework.Bundle addingBundle(org.osgi.framework.Bundle bundle, org.osgi.framework.BundleEvent event)
      Specified by:
      addingBundle in interface org.osgi.util.tracker.BundleTrackerCustomizer<org.osgi.framework.Bundle>

    • modifiedBundle

      public void modifiedBundle(org.osgi.framework.Bundle bundle, org.osgi.framework.BundleEvent event, org.osgi.framework.Bundle object)
      Specified by:
      modifiedBundle in interface org.osgi.util.tracker.BundleTrackerCustomizer<org.osgi.framework.Bundle>

    • removedBundle

      public void removedBundle(org.osgi.framework.Bundle bundle, org.osgi.framework.BundleEvent event, org.osgi.framework.Bundle object)
      Specified by:
      removedBundle in interface org.osgi.util.tracker.BundleTrackerCustomizer<org.osgi.framework.Bundle>

    • createExtension

      private void createExtension(org.osgi.framework.Bundle bundle)

    • destroyExtension

      private void destroyExtension(org.osgi.framework.Bundle bundle)

    • doCreateExtension

      protected abstract Activator.ScrExtension doCreateExtension(org.osgi.framework.Bundle bundle) throws Exception
      Create the extension for the given bundle, or null if the bundle is not to be extended.
      Parameters:
      bundle - the bundle to extend
      Returns:
      The extension
      Throws:
      Exception - If something goes wrong

    • debug

      protected abstract void debug(org.osgi.framework.Bundle bundle, String msg)

    • warn

      protected abstract void warn(org.osgi.framework.Bundle bundle, String msg, Throwable t)