Package org.apache.karaf.features.internal.region

Class Subsystem

java.lang.Object

org.apache.felix.utils.resource.ResourceImpl

org.apache.karaf.features.internal.region.Subsystem

All Implemented Interfaces:

org.osgi.resource.Resource

public class Subsystem
extends org.apache.felix.utils.resource.ResourceImpl

A Resource representing ...

Field Summary

Fields inherited from class org.apache.felix.utils.resource.ResourceImpl

caps, reqs

Constructor Summary

Constructors

Constructor	Description
Subsystem(String name)	Constructs root subsystem Resource for FeaturesService.ROOT_REGION that imports/exports only caps/reqs with (type=karaf.subsystem).
Subsystem(String name, Feature feature, Subsystem parent, boolean mandatory)	Constructs subsystem for a feature that either imports/exports all caps or (see Feature.getScoping()) has configurable import/export policy + (|(type=karaf.subsystem)(type=karaf.feature)) filter in IdentityNamespace.IDENTITY_NAMESPACE.
Subsystem(String name, Subsystem parent, boolean acceptDependencies, boolean mandatory)	Constructs child subsystem Resource for FeaturesService.ROOT_REGION's child that imports all caps and exports only caps with (type=karaf.subsystem).

Method Summary

Modifier and Type	Method	Description
protected void	addRequirement(String requirement)
void	addSystemResource(org.osgi.resource.Resource resource)
void	build(Map<String,List<Feature>> allFeatures)
Set<String>	collectPrerequisites()
Subsystem	createSubsystem(String name, boolean acceptDependencies)	Create child subsystem for this subsystem.
void	downloadBundles(DownloadManager manager, String featureResolutionRange, FeaturesService.ServiceRequirementsBehavior serviceRequirements, RepositoryManager repos, SubsystemResolverCallback callback)	Downloads bundles for all the features in current and child subsystems.
Map<String,BundleInfo>	getBundleInfos()
Subsystem	getChild(String name)
Collection<Subsystem>	getChildren()
Map<String,Set<String>>	getExportPolicy()
Feature	getFeature()
Map<String,Set<String>>	getImportPolicy()
List<org.osgi.resource.Resource>	getInstallable()
String	getName()
Subsystem	getParent()
boolean	isAcceptDependencies()
void	require(String requirement)
void	requireFeature(String name, String range, boolean mandatory)
String	toString()

Methods inherited from class org.apache.felix.utils.resource.ResourceImpl

addCapabilities, addCapability, addRequirement, addRequirements, equals, getCapabilities, getRequirements, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Subsystem

public Subsystem(String name)

Constructs root subsystem Resource for FeaturesService.ROOT_REGION that imports/exports only caps/reqs with (type=karaf.subsystem). Root subsystem by default accepts dependencies - will gather dependant features of child feature subsystems, effectively _flattening_ the set of features within single region's subsystem.

Parameters:

name - The name of the subsystem.

Subsystem

public Subsystem(String name,
                 Feature feature,
                 Subsystem parent,
                 boolean mandatory)

Constructs subsystem for a feature that either imports/exports all caps or (see Feature.getScoping()) has configurable import/export policy + (|(type=karaf.subsystem)(type=karaf.feature)) filter in IdentityNamespace.IDENTITY_NAMESPACE. Such subsystem requires type=karaf.feature; osgi.identity=feature-name[; version=feature-version].

Parameters:

name - The subsystem name.

feature - The feature.

parent - The parent subsystem.

mandatory - True if mandatory, false else.

Subsystem

public Subsystem(String name,
                 Subsystem parent,
                 boolean acceptDependencies,
                 boolean mandatory)

Constructs child subsystem Resource for FeaturesService.ROOT_REGION's child that imports all caps and exports only caps with (type=karaf.subsystem).

Parameters:

name - The subsystem name.

parent - The parent subsystem.

acceptDependencies - True to accept dependencies, false else.

mandatory - True to mandatory, false else.

Method Detail

getInstallable

public List<org.osgi.resource.Resource> getInstallable()

getName

public String getName()

getParent

public Subsystem getParent()

getChildren

public Collection<Subsystem> getChildren()

getChild

public Subsystem getChild(String name)

isAcceptDependencies

public boolean isAcceptDependencies()

getImportPolicy

public Map<String,Set<String>> getImportPolicy()

getExportPolicy

public Map<String,Set<String>> getExportPolicy()

getFeature

public Feature getFeature()

createSubsystem

public Subsystem createSubsystem(String name,
                                 boolean acceptDependencies)

Create child subsystem for this subsystem. Child will become parent's mandatory requirement to force its resolution.

Parameters:

name - The subsystem name.

acceptDependencies - True to accept dependencies, false else.

addSystemResource

public void addSystemResource(org.osgi.resource.Resource resource)

requireFeature

public void requireFeature(String name,
                           String range,
                           boolean mandatory)

require

public void require(String requirement)
             throws org.osgi.framework.BundleException

Throws:

org.osgi.framework.BundleException

addRequirement

protected void addRequirement(String requirement)
                       throws org.osgi.framework.BundleException

Throws:

org.osgi.framework.BundleException

getBundleInfos

public Map<String,BundleInfo> getBundleInfos()

build

public void build(Map<String,List<Feature>> allFeatures)
           throws Exception

Throws:

Exception

collectPrerequisites

public Set<String> collectPrerequisites()

downloadBundles

public void downloadBundles(DownloadManager manager,
                            String featureResolutionRange,
                            FeaturesService.ServiceRequirementsBehavior serviceRequirements,
                            RepositoryManager repos,
                            SubsystemResolverCallback callback)
                     throws Exception

Downloads bundles for all the features in current and child subsystems. But also collects bundles as Subsystem.DependencyInfo.

Parameters:

manager - The DownloadManager to use.

featureResolutionRange - The feature resolution range to use.

serviceRequirements - The FeaturesService.ServiceRequirementsBehavior behavior to use.

repos - The RepositoryManager to use.

callback - The SubsystemResolverCallback to use.

Throws:

Exception

toString

public String toString()

Overrides:

toString in class org.apache.felix.utils.resource.ResourceImpl