File Information
Library: OSP
Package: Bundle
Header: Poco/OSP/BundleManifest.h
Description
The BundleManifest class parses and stores the manifest of a bundle.
Inheritance
Direct Base Classes: Poco::RefCountedObject
All Base Classes: Poco::RefCountedObject
Member Summary
Member Functions: activatorClass, activatorLibrary, copyright, extendedBundle, lazyStart, name, parseActivator, parseManifest, parseProvidedModules, parseRequiredBundles, parseRequiredItems, parseRequiredModules, preventUninstall, providedModules, rawManifest, requiredBundles, requiredModules, runLevel, sealed, symbolicName, vendor, version
Inherited Functions: duplicate, referenceCount, release
Nested Classes
struct Dependency
struct Module
Types Aliases
ConstPtr
Dependencies
using Dependencies = std::vector < Dependency >;
Modules
using Modules = std::vector < Module >;
Ptr
using Ptr = Poco::AutoPtr < BundleManifest >;
Constructors
BundleManifest
BundleManifest(
std::istream & istr
);
Creates the BundleManifest by parsing the META-INF/manifest.mf file.
Destructor
~BundleManifest
~BundleManifest();
Destroys the BundleManifest.
Member Functions
activatorClass
const std::string & activatorClass() const;
Returns the class name of the bundle's activator, or an empty string if the manifest does not specify an activator.
activatorLibrary
const std::string & activatorLibrary() const;
Returns the name of the library containing the bundle's activator class, or an empty string if the manifest does not specify an activator library.
copyright
const std::string & copyright() const;
Returns the bundle's copyright information, or an empty string if no copyright information has been specified in the pManifest->
extendedBundle
const std::string & extendedBundle() const;
Returns the name of the bundle this bundle extends, or an empty string if the bundle is not an extension bundle.
lazyStart
bool lazyStart() const;
Returns true if lazy startup has been specified for the bundle.
name
const std::string & name() const;
Returns the name of the bundle.
preventUninstall
bool preventUninstall() const;
Returns true if the bundle must not be uninstalled at run-time.
This is mostly useful for bundles that cannot be cleanly stopped. An example are bundles that contain third-party libraries that, once loaded, cannot be unloaded cleanly.
providedModules
const Modules & providedModules() const;
Returns a vector containing information about all modules provided by this bundle.
rawManifest
Poco::Util::AbstractConfiguration & rawManifest() const;
Returns a reference to the configuration containing the raw manifest data.
requiredBundles
const Dependencies & requiredBundles() const;
Returns a vector containing information about all bundles required by this bundle.
requiredModules
const Dependencies & requiredModules() const;
Returns a vector containing information about all modules required by this bundle.
runLevel
const std::string & runLevel() const;
Returns the bundle's run level.
If the bundle does not specify a run level, returns the default "999-user".
sealed
bool sealed() const;
Returns true if the bundle is sealed and cannot be extended by an extension bundle.
symbolicName
const std::string & symbolicName() const;
Returns the symbolic name of the bundle.
vendor
const std::string & vendor() const;
Returns the bundle's vendor name, or an empty string if no vendor name has been specified in the pManifest->
version
const Version & version() const;
Returns the version of the bundle.
parseActivator
void parseActivator(
const std::string & activator
);
Parses the Bundle-Activator property.
parseManifest
void parseManifest();
Parses the bundle's manifest file.
parseProvidedModules
void parseProvidedModules(
const std::string & providedModules
);
Parses the Provided-Modules property.
parseRequiredBundles
void parseRequiredBundles(
const std::string & requiredBundles
);
Parses the Required-Bundles property.
parseRequiredItems
void parseRequiredItems(
const std::string & requiredItems,
const std::string & what,
const std::string & versionKeyword,
Dependencies & dependencies
);
Parses the Required-Bundles or Required-Modules property and stored result in dependencies.
parseRequiredModules
void parseRequiredModules(
const std::string & requiredModules
);
Parses the Required-Modules property.
Variables
BUNDLE_ACTIVATOR
static const std::string BUNDLE_ACTIVATOR;
BUNDLE_CERTIFICATE
static const std::string BUNDLE_CERTIFICATE;
BUNDLE_COPYRIGHT
static const std::string BUNDLE_COPYRIGHT;
BUNDLE_LAZYSTART
static const std::string BUNDLE_LAZYSTART;
BUNDLE_NAME
static const std::string BUNDLE_NAME;
BUNDLE_PREVENTUNINSTALL
static const std::string BUNDLE_PREVENTUNINSTALL;
BUNDLE_RUNLEVEL
static const std::string BUNDLE_RUNLEVEL;
BUNDLE_SEALED
static const std::string BUNDLE_SEALED;
BUNDLE_SYMBOLICNAME
static const std::string BUNDLE_SYMBOLICNAME;
BUNDLE_VENDOR
static const std::string BUNDLE_VENDOR;
BUNDLE_VERSION
static const std::string BUNDLE_VERSION;
DEFAULT_RUNLEVEL
static const std::string DEFAULT_RUNLEVEL;
EXTENDS_BUNDLE
static const std::string EXTENDS_BUNDLE;
MANIFEST_VERSION
static const std::string MANIFEST_VERSION;
PROVIDE_MODULE
static const std::string PROVIDE_MODULE;
REQUIRE_BUNDLE
static const std::string REQUIRE_BUNDLE;
REQUIRE_MODULE
static const std::string REQUIRE_MODULE;
VERSION
static const std::string VERSION;