Package org.apache.karaf.features.internal.service

Class FeaturesServiceImpl

java.lang.Object

org.apache.karaf.features.internal.service.FeaturesServiceImpl

All Implemented Interfaces:

FeaturesService, SubsystemResolverCallback, Deployer.DeployCallback

public class FeaturesServiceImpl
extends Object
implements FeaturesService, Deployer.DeployCallback

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.karaf.features.FeaturesService

FeaturesService.Option, FeaturesService.ServiceRequirementsBehavior, FeaturesService.SnapshotUpdateBehavior

Field Summary

Fields inherited from interface org.apache.karaf.features.FeaturesService

DEFAULT_AUTO_REFRESH, DEFAULT_BUNDLE_UPDATE_RANGE, DEFAULT_CONFIG_CFG_STORE, DEFAULT_DIGRAPH_MBEAN, DEFAULT_DOWNLOAD_THREADS, DEFAULT_FEATURE_RESOLUTION_RANGE, DEFAULT_REPOSITORY_EXPIRATION, DEFAULT_SCHEDULE_DELAY, DEFAULT_SCHEDULE_MAX_RUN, DEFAULT_UPDATE_SNAPSHOTS, ROOT_REGION, UPDATEABLE_URIS

Constructor Summary

Constructors

Constructor	Description
FeaturesServiceImpl(StateStorage storage, FeatureRepoFinder featureFinder, org.osgi.service.cm.ConfigurationAdmin configurationAdmin, org.osgi.service.resolver.Resolver resolver, BundleInstallSupport installSupport, org.osgi.service.repository.Repository globalRepository, FeaturesServiceConfig cfg)

Method Summary

Modifier and Type	Method	Description
void	addRepository(URI uri)
void	addRepository(URI uri, boolean install)
void	addRequirements(Map<String,Set<String>> requirements, EnumSet<FeaturesService.Option> options)
void	bundleBlacklisted(BundleInfo bundleInfo)	Notification about bundle being blacklisted
void	callListeners(DeploymentEvent event)
void	callListeners(FeatureEvent event)
protected void	callListeners(RepositoryEvent event)
protected DownloadManager	createDownloadManager()
Repository	createRepository(URI uri)
void	deleteConfigs(Feature feature)
Feature	getFeature(String name)
Feature	getFeature(String name, String version)
protected Map<String,Map<String,Feature>>	getFeatureCache()	Should not be called while holding a lock.
Feature[]	getFeatures(String nameOrId)
Feature[]	getFeatures(String name, String version)
protected Map<String,Feature>	getFeaturesById()
String	getFeatureXml(Feature feature)
Repository	getRepository(String name)
Repository	getRepository(URI uri)
String	getRepositoryName(URI uri)
String[]	getRepositoryNames()
URI	getRepositoryUriFor(String name, String version)
FeatureState	getState(String featureId)
org.osgi.framework.Bundle	installBundle(String region, String uri, InputStream is)
void	installConfigs(Feature feature)
void	installFeature(String name)
void	installFeature(String name, String version)
void	installFeature(String name, String version, EnumSet<FeaturesService.Option> options)
void	installFeature(String name, EnumSet<FeaturesService.Option> options)
void	installFeature(Feature feature, EnumSet<FeaturesService.Option> options)
void	installFeatures(Set<String> featuresIn, String region, EnumSet<FeaturesService.Option> options)
void	installFeatures(Set<String> features, EnumSet<FeaturesService.Option> options)
void	installLibraries(Feature feature)
boolean	isInstalled(Feature f)
boolean	isRepositoryUriBlacklisted(URI uri)
boolean	isRequired(Feature f)
Feature[]	listFeatures()
Feature[]	listInstalledFeatures()
Repository[]	listRepositories()
Feature[]	listRequiredFeatures()
Repository[]	listRequiredRepositories()
Map<String,Set<String>>	listRequirements()
protected void	loadState()
void	persistResolveRequest(Deployer.DeploymentRequest request)
void	print(String message, boolean verbose)
void	refreshFeatures(EnumSet<FeaturesService.Option> options)
void	refreshPackages(Collection<org.osgi.framework.Bundle> bundles)
void	refreshRepositories(Set<URI> uris)
void	refreshRepository(URI uri)
void	registerListener(DeploymentListener listener)
void	registerListener(FeaturesListener listener)
void	removeRepository(URI uri)
void	removeRepository(URI uri, boolean uninstall)
void	removeRequirements(Map<String,Set<String>> requirements, EnumSet<FeaturesService.Option> options)
void	replaceDigraph(Map<String,Map<String,Map<String,Set<String>>>> policies, Map<String,Set<Long>> bundles)
Feature[]	repositoryProvidedFeatures(URI uri)
void	resolveBundles(Set<org.osgi.framework.Bundle> bundles, Map<org.osgi.resource.Resource,List<org.osgi.resource.Wire>> wiring, Map<org.osgi.resource.Resource,org.osgi.framework.Bundle> resToBnd)
void	restoreRepository(URI uri)
protected void	saveState()
void	saveState(State state)
void	setBundleStartLevel(org.osgi.framework.Bundle bundle, int startLevel)
void	setResolutionOutputFile(String outputFile)
void	startBundle(org.osgi.framework.Bundle bundle)
void	stop()
void	stopBundle(org.osgi.framework.Bundle bundle, int options)
void	uninstall(org.osgi.framework.Bundle bundle)
void	uninstallFeature(String name)
void	uninstallFeature(String name, String version)
void	uninstallFeature(String name, String version, EnumSet<FeaturesService.Option> options)
void	uninstallFeature(String name, EnumSet<FeaturesService.Option> options)
void	uninstallFeatures(Set<String> featuresIn, String region, EnumSet<FeaturesService.Option> options)
void	uninstallFeatures(Set<String> features, EnumSet<FeaturesService.Option> options)
void	unregisterListener(DeploymentListener listener)
void	unregisterListener(FeaturesListener listener)
void	updateBundle(org.osgi.framework.Bundle bundle, String uri, InputStream is)
void	updateFeaturesState(Map<String,Map<String,FeatureState>> stateChanges, EnumSet<FeaturesService.Option> options)
void	updateReposAndRequirements(Set<URI> repos, Map<String,Set<String>> requirements, EnumSet<FeaturesService.Option> options)
void	validateRepository(URI uri)	Validate repository contents.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FeaturesServiceImpl

public FeaturesServiceImpl(StateStorage storage,
                           FeatureRepoFinder featureFinder,
                           org.osgi.service.cm.ConfigurationAdmin configurationAdmin,
                           org.osgi.service.resolver.Resolver resolver,
                           BundleInstallSupport installSupport,
                           org.osgi.service.repository.Repository globalRepository,
                           FeaturesServiceConfig cfg)

Method Detail

stop

public void stop()

loadState

protected void loadState()

saveState

protected void saveState()

registerListener

public void registerListener(FeaturesListener listener)

Specified by:

registerListener in interface FeaturesService

unregisterListener

public void unregisterListener(FeaturesListener listener)

Specified by:

unregisterListener in interface FeaturesService

registerListener

public void registerListener(DeploymentListener listener)

Specified by:

registerListener in interface FeaturesService

unregisterListener

public void unregisterListener(DeploymentListener listener)

Specified by:

unregisterListener in interface FeaturesService

callListeners

public void callListeners(FeatureEvent event)

Specified by:

callListeners in interface Deployer.DeployCallback

callListeners

public void callListeners(DeploymentEvent event)

Specified by:

callListeners in interface Deployer.DeployCallback

callListeners

protected void callListeners(RepositoryEvent event)

getRepositoryUriFor

public URI getRepositoryUriFor(String name,
                               String version)

Specified by:

getRepositoryUriFor in interface FeaturesService

getRepositoryNames

public String[] getRepositoryNames()

Specified by:

getRepositoryNames in interface FeaturesService

repositoryProvidedFeatures

public Feature[] repositoryProvidedFeatures(URI uri)
                                     throws Exception

Specified by:

repositoryProvidedFeatures in interface FeaturesService

Throws:

Exception

validateRepository

public void validateRepository(URI uri)
                        throws Exception

Description copied from interface: FeaturesService

Validate repository contents.

Specified by:

validateRepository in interface FeaturesService

Parameters:

uri - Repository uri.

Throws:

Exception - When validation fails.

isRepositoryUriBlacklisted

public boolean isRepositoryUriBlacklisted(URI uri)

Specified by:

isRepositoryUriBlacklisted in interface FeaturesService

addRepository

public void addRepository(URI uri)
                   throws Exception

Specified by:

addRepository in interface FeaturesService

Throws:

Exception

addRepository

public void addRepository(URI uri,
                          boolean install)
                   throws Exception

Specified by:

addRepository in interface FeaturesService

Throws:

Exception

removeRepository

public void removeRepository(URI uri)
                      throws Exception

Specified by:

removeRepository in interface FeaturesService

Throws:

Exception

removeRepository

public void removeRepository(URI uri,
                             boolean uninstall)
                      throws Exception

Specified by:

removeRepository in interface FeaturesService

Throws:

Exception

restoreRepository

public void restoreRepository(URI uri)
                       throws Exception

Specified by:

restoreRepository in interface FeaturesService

Throws:

Exception

refreshRepository

public void refreshRepository(URI uri)
                       throws Exception

Specified by:

refreshRepository in interface FeaturesService

Throws:

Exception

refreshRepositories

public void refreshRepositories(Set<URI> uris)
                         throws Exception

Specified by:

refreshRepositories in interface FeaturesService

Throws:

Exception

listRepositories

public Repository[] listRepositories()
                              throws Exception

Specified by:

listRepositories in interface FeaturesService

Throws:

Exception

listRequiredRepositories

public Repository[] listRequiredRepositories()
                                      throws Exception

Specified by:

listRequiredRepositories in interface FeaturesService

Throws:

Exception

getRepository

public Repository getRepository(String name)
                         throws Exception

Specified by:

getRepository in interface FeaturesService

Throws:

Exception

getRepository

public Repository getRepository(URI uri)
                         throws Exception

Specified by:

getRepository in interface FeaturesService

Throws:

Exception

getRepositoryName

public String getRepositoryName(URI uri)
                         throws Exception

Specified by:

getRepositoryName in interface FeaturesService

Throws:

Exception

getFeature

public Feature getFeature(String name)
                   throws Exception

Specified by:

getFeature in interface FeaturesService

Throws:

Exception

getFeature

public Feature getFeature(String name,
                          String version)
                   throws Exception

Specified by:

getFeature in interface FeaturesService

Throws:

Exception

getFeatures

public Feature[] getFeatures(String nameOrId)
                      throws Exception

Specified by:

getFeatures in interface FeaturesService

Throws:

Exception

getFeatures

public Feature[] getFeatures(String name,
                             String version)
                      throws Exception

Specified by:

getFeatures in interface FeaturesService

Throws:

Exception

getFeatureCache

protected Map<String,Map<String,Feature>> getFeatureCache()
                                                               throws Exception

Should not be called while holding a lock.

Returns:

map from feature name to map from feature version to Feature

Throws:

Exception

getFeaturesById

protected Map<String,Feature> getFeaturesById()
                                             throws Exception

Throws:

Exception

listFeatures

public Feature[] listFeatures()
                       throws Exception

Specified by:

listFeatures in interface FeaturesService

Throws:

Exception

listInstalledFeatures

public Feature[] listInstalledFeatures()
                                throws Exception

Specified by:

listInstalledFeatures in interface FeaturesService

Throws:

Exception

listRequiredFeatures

public Feature[] listRequiredFeatures()
                               throws Exception

Specified by:

listRequiredFeatures in interface FeaturesService

Throws:

Exception

isInstalled

public boolean isInstalled(Feature f)

Specified by:

isInstalled in interface FeaturesService

getState

public FeatureState getState(String featureId)

Specified by:

getState in interface FeaturesService

isRequired

public boolean isRequired(Feature f)

Specified by:

isRequired in interface FeaturesService

installFeature

public void installFeature(String name)
                    throws Exception

Specified by:

installFeature in interface FeaturesService

Throws:

Exception

installFeature

public void installFeature(String name,
                           String version)
                    throws Exception

Specified by:

installFeature in interface FeaturesService

Throws:

Exception

installFeature

public void installFeature(String name,
                           EnumSet<FeaturesService.Option> options)
                    throws Exception

Specified by:

installFeature in interface FeaturesService

Throws:

Exception

installFeature

public void installFeature(String name,
                           String version,
                           EnumSet<FeaturesService.Option> options)
                    throws Exception

Specified by:

installFeature in interface FeaturesService

Throws:

Exception

installFeature

public void installFeature(Feature feature,
                           EnumSet<FeaturesService.Option> options)
                    throws Exception

Specified by:

installFeature in interface FeaturesService

Throws:

Exception

installFeatures

public void installFeatures(Set<String> features,
                            EnumSet<FeaturesService.Option> options)
                     throws Exception

Specified by:

installFeatures in interface FeaturesService

Throws:

Exception

uninstallFeature

public void uninstallFeature(String name,
                             String version)
                      throws Exception

Specified by:

uninstallFeature in interface FeaturesService

Throws:

Exception

uninstallFeature

public void uninstallFeature(String name,
                             String version,
                             EnumSet<FeaturesService.Option> options)
                      throws Exception

Specified by:

uninstallFeature in interface FeaturesService

Throws:

Exception

uninstallFeature

public void uninstallFeature(String name)
                      throws Exception

Specified by:

uninstallFeature in interface FeaturesService

Throws:

Exception

uninstallFeature

public void uninstallFeature(String name,
                             EnumSet<FeaturesService.Option> options)
                      throws Exception

Specified by:

uninstallFeature in interface FeaturesService

Throws:

Exception

uninstallFeatures

public void uninstallFeatures(Set<String> features,
                              EnumSet<FeaturesService.Option> options)
                       throws Exception

Specified by:

uninstallFeatures in interface FeaturesService

Throws:

Exception

setResolutionOutputFile

public void setResolutionOutputFile(String outputFile)

Specified by:

setResolutionOutputFile in interface FeaturesService

installFeatures

public void installFeatures(Set<String> featuresIn,
                            String region,
                            EnumSet<FeaturesService.Option> options)
                     throws Exception

Specified by:

installFeatures in interface FeaturesService

Throws:

Exception

uninstallFeatures

public void uninstallFeatures(Set<String> featuresIn,
                              String region,
                              EnumSet<FeaturesService.Option> options)
                       throws Exception

Specified by:

uninstallFeatures in interface FeaturesService

Throws:

Exception

updateFeaturesState

public void updateFeaturesState(Map<String,Map<String,FeatureState>> stateChanges,
                                EnumSet<FeaturesService.Option> options)
                         throws Exception

Specified by:

updateFeaturesState in interface FeaturesService

Throws:

Exception

addRequirements

public void addRequirements(Map<String,Set<String>> requirements,
                            EnumSet<FeaturesService.Option> options)
                     throws Exception

Specified by:

addRequirements in interface FeaturesService

Throws:

Exception

removeRequirements

public void removeRequirements(Map<String,Set<String>> requirements,
                               EnumSet<FeaturesService.Option> options)
                        throws Exception

Specified by:

removeRequirements in interface FeaturesService

Throws:

Exception

updateReposAndRequirements

public void updateReposAndRequirements(Set<URI> repos,
                                       Map<String,Set<String>> requirements,
                                       EnumSet<FeaturesService.Option> options)
                                throws Exception

Specified by:

updateReposAndRequirements in interface FeaturesService

Throws:

Exception

createRepository

public Repository createRepository(URI uri)
                            throws Exception

Specified by:

createRepository in interface FeaturesService

Throws:

Exception

listRequirements

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

Specified by:

listRequirements in interface FeaturesService

createDownloadManager

protected DownloadManager createDownloadManager()
                                         throws IOException

Throws:

IOException

print

public void print(String message,
                  boolean verbose)

Specified by:

print in interface Deployer.DeployCallback

saveState

public void saveState(State state)

Specified by:

saveState in interface Deployer.DeployCallback

persistResolveRequest

public void persistResolveRequest(Deployer.DeploymentRequest request)
                           throws IOException

Specified by:

persistResolveRequest in interface Deployer.DeployCallback

Throws:

IOException

refreshPackages

public void refreshPackages(Collection<org.osgi.framework.Bundle> bundles)
                     throws InterruptedException

Specified by:

refreshPackages in interface Deployer.DeployCallback

Throws:

InterruptedException

installBundle

public org.osgi.framework.Bundle installBundle(String region,
                                               String uri,
                                               InputStream is)
                                        throws org.osgi.framework.BundleException

Specified by:

installBundle in interface Deployer.DeployCallback

Throws:

org.osgi.framework.BundleException

updateBundle

public void updateBundle(org.osgi.framework.Bundle bundle,
                         String uri,
                         InputStream is)
                  throws org.osgi.framework.BundleException

Specified by:

updateBundle in interface Deployer.DeployCallback

Throws:

org.osgi.framework.BundleException

uninstall

public void uninstall(org.osgi.framework.Bundle bundle)
               throws org.osgi.framework.BundleException

Specified by:

uninstall in interface Deployer.DeployCallback

Throws:

org.osgi.framework.BundleException

startBundle

public void startBundle(org.osgi.framework.Bundle bundle)
                 throws org.osgi.framework.BundleException

Specified by:

startBundle in interface Deployer.DeployCallback

Throws:

org.osgi.framework.BundleException

stopBundle

public void stopBundle(org.osgi.framework.Bundle bundle,
                       int options)
                throws org.osgi.framework.BundleException

Specified by:

stopBundle in interface Deployer.DeployCallback

Throws:

org.osgi.framework.BundleException

setBundleStartLevel

public void setBundleStartLevel(org.osgi.framework.Bundle bundle,
                                int startLevel)

Specified by:

setBundleStartLevel in interface Deployer.DeployCallback

resolveBundles

public void resolveBundles(Set<org.osgi.framework.Bundle> bundles,
                           Map<org.osgi.resource.Resource,List<org.osgi.resource.Wire>> wiring,
                           Map<org.osgi.resource.Resource,org.osgi.framework.Bundle> resToBnd)

Specified by:

resolveBundles in interface Deployer.DeployCallback

replaceDigraph

public void replaceDigraph(Map<String,Map<String,Map<String,Set<String>>>> policies,
                           Map<String,Set<Long>> bundles)
                    throws org.osgi.framework.BundleException,
                           org.osgi.framework.InvalidSyntaxException

Specified by:

replaceDigraph in interface Deployer.DeployCallback

Throws:

org.osgi.framework.BundleException

org.osgi.framework.InvalidSyntaxException

installConfigs

public void installConfigs(Feature feature)
                    throws IOException,
                           org.osgi.framework.InvalidSyntaxException

Specified by:

installConfigs in interface Deployer.DeployCallback

Throws:

IOException

org.osgi.framework.InvalidSyntaxException

deleteConfigs

public void deleteConfigs(Feature feature)
                   throws IOException,
                          org.osgi.framework.InvalidSyntaxException

Specified by:

deleteConfigs in interface Deployer.DeployCallback

Throws:

IOException

org.osgi.framework.InvalidSyntaxException

installLibraries

public void installLibraries(Feature feature)
                      throws IOException

Specified by:

installLibraries in interface Deployer.DeployCallback

Throws:

IOException

bundleBlacklisted

public void bundleBlacklisted(BundleInfo bundleInfo)

Description copied from interface: SubsystemResolverCallback

Notification about bundle being blacklisted

Specified by:

bundleBlacklisted in interface SubsystemResolverCallback

getFeatureXml

public String getFeatureXml(Feature feature)

Specified by:

getFeatureXml in interface FeaturesService

refreshFeatures

public void refreshFeatures(EnumSet<FeaturesService.Option> options)
                     throws Exception

Specified by:

refreshFeatures in interface FeaturesService

Throws:

Exception