@ConsumerType public interface ModuleConnector
ModuleConnectorprovides connections to instances of
ConnectModulethat are used by a
Frameworkinstance to connect installed bundles locations with content provided by the
This allows a
ModuleConnector to provide content and classes for a
connected bundle installed in the
ModuleConnector is provided when
framework instance. Because a
ModuleConnector instance can
participate in the initialization of the
Framework and the life cycle
Framework instance the
ModuleConnector instance should
only be used with a single
Framework instance at a time.
|Modifier and Type||Method and Description|
Connects a bundle location with a
Creates a new activator for this
void initialize(java.io.File storage, java.util.Map<java.lang.String,java.lang.String> configuration)
framework persistent storagefile and framework properties configured for a
This method is called once by a
Framework instance and is called
before any other methods on this module connector are called.
storage- The persistent storage area used by the
nullif the platform does not have file system support.
configuration- An unmodifiable map of framework configuration properties that were used to configure the new framework instance.
java.util.Optional<ConnectModule> connect(java.lang.String location) throws BundleException
When the result is empty, then the framework must handle reading the
content of the bundle itself. Otherwise, the returned
ConnectModule must be used by the framework to access the content
of the bundle.
location- The bundle location used to install a bundle.
ConnectModulefor the specified bundle location, or an empty
Optionalif the framework must handle reading the content of the bundle itself.
BundleException- If the location cannot be handled.
This method is called by the framework during framework
initialization. Returning an
activator allows this
ModuleConnector to participate in the
framework life cycle. If an activator is returned:
Copyright © OSGi Alliance (2000, 2020). All Rights Reserved. Licensed under the OSGi Specification License, Version 2.0