Package org.apache.felix.framework

Class ExtensionManager

java.lang.Object
org.apache.felix.framework.ExtensionManager
All Implemented Interfaces:
Content
class ExtensionManager extends Object implements Content
The ExtensionManager class is used as content loader of the systembundle. Added extension bundles exports will be available via this loader.

  • Field Details

  • Constructor Details

    • ExtensionManager

      ExtensionManager(Logger logger, Map<String,?> configMap, Felix felix)
      This constructor is used to create one instance per framework instance. The general approach is to have one private static instance that we register with the parent classloader and one instance per framework instance that keeps track of extension bundles and systembundle exports for that framework instance.
      Parameters:
      logger - the logger to use.

  • Method Details

    • buildNativeCapabilites

      protected BundleCapability buildNativeCapabilites(BundleRevisionImpl revision, Map<String,?> configMap)

    • updateRevision

      @IgnoreJRERequirement void updateRevision(Felix felix, Map<String,?> configMap)

    • getRevision

      public BundleRevisionImpl getRevision()

    • addExtensionBundle

      void addExtensionBundle(BundleImpl bundle) throws Exception
      Add an extension bundle. The bundle will be added to the parent classloader and it's exported packages will be added to the module definition exports of this instance. Subsequently, they are available form the instance in it's role as content loader.
      Parameters:
      bundle - the extension bundle to add.
      Throws:
      BundleException - if extension bundles are not supported or this is not a framework extension.
      SecurityException - if the caller does not have the needed AdminPermission.EXTENSIONLIFECYCLE and security is enabled.
      Exception - in case something goes wrong.

    • resolveExtensionBundles

      public List<Bundle> resolveExtensionBundles(Felix felix)

    • startExtensionBundle

      void startExtensionBundle(Felix felix, BundleImpl bundle)
      Start extension bundle if it has an activator
      Parameters:
      felix - the framework instance the extension bundle is installed in.
      bundle - the extension bundle to start if it has a an extension bundle activator.

    • startPendingExtensionBundles

      void startPendingExtensionBundles(Felix felix)

    • stopExtensionBundles

      void stopExtensionBundles(Felix felix)

    • removeExtensionBundles

      public void removeExtensionBundles()

    • findResolvableExtensions

      private Map<BundleRevisionImpl,List<BundleWire>> findResolvableExtensions(List<BundleRevisionImpl> extensions, List<BundleRevisionImpl> alt)

    • close

      public void close()
      Description copied from interface: Content

      This method must be called when the content is no longer needed so that any resourses being used (e.g., open files) can be closed. Once this method is called, the content is no longer usable. If the content is already closed, then calls on this method should have no effect.

      Specified by:
      close in interface Content

    • getEntries

      public Enumeration<String> getEntries()
      Description copied from interface: Content

      Returns an enumeration of entry names as String objects. An entry name is a path constructed with '/' as path element separators and is relative to the root of the content. Entry names for entries that represent directories should end with the '/' character.

      Specified by:
      getEntries in interface Content

    • hasEntry

      public boolean hasEntry(String name)
      Description copied from interface: Content

      This method determines if the specified named entry is contained in the associated content. The entry name is a relative path with '/' separators.

      Specified by:
      hasEntry in interface Content
      Parameters:
      name - The name of the entry to find.
      Returns:
      true if a corresponding entry was found, false otherwise.

    • isDirectory

      public boolean isDirectory(String name)
      Description copied from interface: Content

      This method determines if the specified named entry is contained in the associated content and is a directory. The entry name is a relative path with '/' separators.

      Specified by:
      isDirectory in interface Content
      Parameters:
      name - The name of the entry to find.
      Returns:
      true if a corresponding entry was found and is a directory, false otherwise.

    • getEntryAsBytes

      public byte[] getEntryAsBytes(String name)
      Description copied from interface: Content

      This method returns the named entry as an array of bytes.

      Specified by:
      getEntryAsBytes in interface Content
      Parameters:
      name - The name of the entry to retrieve as a byte array.
      Returns:
      An array of bytes if the corresponding entry was found, null otherwise.

    • getEntryAsStream

      public InputStream getEntryAsStream(String name) throws IOException
      Description copied from interface: Content

      This method returns the named entry as an input stream.

      Specified by:
      getEntryAsStream in interface Content
      Parameters:
      name - The name of the entry to retrieve as an input stream.
      Returns:
      An input stream if the corresponding entry was found, null otherwise.
      Throws:
      IOException

    • getEntryAsContent

      public Content getEntryAsContent(String name)
      Description copied from interface: Content

      This method returns the named entry as an IContent Typically, this method only makes sense for entries that correspond to some form of aggregated resource (e.g., an embedded JAR file or directory), but implementations are free to interpret this however makes sense. This method should return a new IContent instance for every invocation and the caller is responsible for opening and closing the returned content object.

      Specified by:
      getEntryAsContent in interface Content
      Parameters:
      name - The name of the entry to retrieve as an IContent.
      Returns:
      An IContent instance if a corresponding entry was found, null otherwise.

    • getEntryAsNativeLibrary

      public String getEntryAsNativeLibrary(String name)
      Description copied from interface: Content

      This method returns the named entry as a file in the file system for use as a native library. It may not be possible for all content implementations (e.g., memory only) to implement this method, in which case it is acceptable to return null. Since native libraries can only be associated with a single class loader, this method should return a unique file per request.

      Specified by:
      getEntryAsNativeLibrary in interface Content
      Parameters:
      name - The name of the entry to retrieve as a file.
      Returns:
      A string corresponding to the absolute path of the file if a corresponding entry was found, null otherwise.

    • getEntryAsURL

      public URL getEntryAsURL(String name)
      Description copied from interface: Content

      This method allows retrieving an entry as a local URL.

      Specified by:
      getEntryAsURL in interface Content
      Parameters:
      name - The name of the entry to retrieve as a URL
      Returns:
      A URL using a local protocol such as file, jar or null if not possible.

    • getContentTime

      public long getContentTime(String name)
      Specified by:
      getContentTime in interface Content