/******************************************************************************* * Copyright (c) 2007, 2018 IBM Corporation and others. * All rights reserved. * This program and the accompanying materials are made available under the * terms of the Eclipse Public License 2.0 which accompanies this distribution, * and is available at * https://www.eclipse.org/legal/epl-2.0/ * * SPDX-License-Identifier: EPL-2.0 * * Contributors: * IBM Corporation - initial API and implementation * Red Hat, Inc (Krzysztof Daniel) - Bug 421935: Extend simpleconfigurator to * read .info files from many locations, Bug 460967 *******************************************************************************/ package org.eclipse.equinox.internal.simpleconfigurator; import java.io.*; import java.net.*; import java.util.*; import java.util.concurrent.CountDownLatch; import org.eclipse.equinox.internal.simpleconfigurator.utils.*; import org.osgi.framework.*; import org.osgi.framework.namespace.*; import org.osgi.framework.wiring.*; import org.osgi.resource.Namespace; import org.osgi.resource.Requirement; import org.osgi.service.packageadmin.PackageAdmin; import org.osgi.service.startlevel.StartLevel; class ConfigApplier { private static final String LAST_BUNDLES_INFO = "last.bundles.info"; //$NON-NLS-1$ private static final String PROP_DEVMODE = "osgi.dev"; //$NON-NLS-1$ private final BundleContext manipulatingContext; private final PackageAdmin packageAdminService; private final StartLevel startLevelService; private final FrameworkWiring frameworkWiring; private final boolean runningOnEquinox; private final boolean inDevMode; private final Bundle callingBundle; private final URI baseLocation; ConfigApplier(BundleContext context, Bundle callingBundle) { manipulatingContext = context; this.callingBundle = callingBundle; runningOnEquinox = "Eclipse".equals(context.getProperty(Constants.FRAMEWORK_VENDOR)); //$NON-NLS-1$ inDevMode = manipulatingContext.getProperty(PROP_DEVMODE) != null; baseLocation = runningOnEquinox ? EquinoxUtils.getInstallLocationURI(context) : null; ServiceReference packageAdminRef = manipulatingContext.getServiceReference(PackageAdmin.class); if (packageAdminRef == null) throw new IllegalStateException("No PackageAdmin service is available."); //$NON-NLS-1$ packageAdminService = manipulatingContext.getService(packageAdminRef); ServiceReference startLevelRef = manipulatingContext.getServiceReference(StartLevel.class); if (startLevelRef == null) throw new IllegalStateException("No StartLevelService service is available."); //$NON-NLS-1$ startLevelService = manipulatingContext.getService(startLevelRef); frameworkWiring = manipulatingContext.getBundle(Constants.SYSTEM_BUNDLE_LOCATION).adapt(FrameworkWiring.class); } void install(URL url, boolean exclusiveMode) throws IOException { List bundleInfoList = SimpleConfiguratorUtils.readConfiguration(url, baseLocation); if (Activator.DEBUG) System.out.println("applyConfiguration() bundleInfoList.size()=" + bundleInfoList.size()); if (bundleInfoList.size() == 0) return; BundleInfo[] expectedState = Utils.getBundleInfosFromList(bundleInfoList); // check for an update to the system bundle String systemBundleSymbolicName = manipulatingContext.getBundle(0).getSymbolicName(); Version systemBundleVersion = manipulatingContext.getBundle(0).getVersion(); if (systemBundleSymbolicName != null) { for (BundleInfo element : expectedState) { String symbolicName = element.getSymbolicName(); if (!systemBundleSymbolicName.equals(symbolicName)) continue; Version version = Version.parseVersion(element.getVersion()); if (!systemBundleVersion.equals(version)) throw new IllegalStateException("The System Bundle was updated. The framework must be restarted to finalize the configuration change"); } } HashSet toUninstall = null; if (!exclusiveMode) { BundleInfo[] lastInstalledBundles = getLastState(); if (lastInstalledBundles != null) { toUninstall = new HashSet<>(Arrays.asList(lastInstalledBundles)); toUninstall.removeAll(Arrays.asList(expectedState)); } saveStateAsLast(url); } Set prevouslyResolved = getResolvedBundles(); Collection toRefresh = new ArrayList<>(); Collection toStart = new ArrayList<>(); if (exclusiveMode) { toRefresh.addAll(installBundles(expectedState, toStart)); toRefresh.addAll(uninstallBundles(expectedState, packageAdminService)); } else { toRefresh.addAll(installBundles(expectedState, toStart)); if (toUninstall != null) toRefresh.addAll(uninstallBundles(toUninstall)); } refreshPackages(toRefresh.toArray(new Bundle[toRefresh.size()]), manipulatingContext); if (toRefresh.size() > 0) { Bundle[] additionalRefresh = getAdditionalRefresh(prevouslyResolved, toRefresh); if (additionalRefresh.length > 0) refreshPackages(additionalRefresh, manipulatingContext); } startBundles(toStart.toArray(new Bundle[toStart.size()])); } private Bundle[] getAdditionalRefresh(Set previouslyResolved, Collection toRefresh) { // This is the luna equinox framework or a non-equinox framework. // Use standard OSGi API. final Set additionalRefresh = new HashSet<>(); final Set originalRefresh = new HashSet<>(toRefresh); for (Bundle bundle : toRefresh) { BundleRevision revision = bundle.adapt(BundleRevision.class); if (bundle.getState() == Bundle.INSTALLED && revision != null && (revision.getTypes() & BundleRevision.TYPE_FRAGMENT) != 0) { // this is an unresolved fragment; look to see if it has additional payload requirements boolean foundPayLoadReq = false; BundleRequirement hostReq = null; Collection requirements = revision.getRequirements(null); for (Requirement requirement : requirements) { BundleRequirement req = (BundleRequirement) requirement; if (HostNamespace.HOST_NAMESPACE.equals(req.getNamespace())) { hostReq = req; } if (!HostNamespace.HOST_NAMESPACE.equals(req.getNamespace()) && !ExecutionEnvironmentNamespace.EXECUTION_ENVIRONMENT_NAMESPACE.equals(req.getNamespace())) { // found a payload requirement foundPayLoadReq = true; } } if (foundPayLoadReq) { Collection candidates = frameworkWiring.findProviders(hostReq); for (BundleCapability candidate : candidates) { if (!originalRefresh.contains(candidate.getRevision().getBundle())) { additionalRefresh.add(candidate.getRevision().getBundle()); } } } } } for (Bundle bundle : previouslyResolved) { BundleRevision revision = bundle.adapt(BundleRevision.class); BundleWiring wiring = revision == null ? null : revision.getWiring(); if (wiring != null) { Collection reqs = revision.getDeclaredRequirements(null); Set optionalReqs = new HashSet<>(); for (BundleRequirement req : reqs) { String namespace = req.getNamespace(); // only do this for package and bundle namespaces if (PackageNamespace.PACKAGE_NAMESPACE.equals(namespace) || BundleNamespace.BUNDLE_NAMESPACE.equals(namespace)) { if (Namespace.RESOLUTION_OPTIONAL.equals(req.getDirectives().get(Namespace.REQUIREMENT_RESOLUTION_DIRECTIVE))) { optionalReqs.add(req); } } } if (!optionalReqs.isEmpty()) { wiring = getHostWiring(wiring); // check that all optional requirements are wired Collection requiredWires = wiring.getRequiredWires(null); for (BundleWire requiredWire : requiredWires) { optionalReqs.remove(requiredWire.getRequirement()); } if (!optionalReqs.isEmpty()) { // there are a number of optional requirements not wired for (BundleRequirement bundleRequirement : optionalReqs) { Collection candidates = frameworkWiring.findProviders(bundleRequirement); // Filter out candidates that were previously resolved or are currently not resolved. // There is no need to refresh the resource if the candidate was previously available. for (Iterator iCandidates = candidates.iterator(); iCandidates.hasNext();) { BundleCapability candidate = iCandidates.next(); Bundle candidateBundle = candidate.getRevision().getBundle(); // The candidate is not from the original refresh set, but // it could have just became resolved as a result of new bundles. if (previouslyResolved.contains(candidateBundle) || candidateBundle.getState() == Bundle.INSTALLED) { iCandidates.remove(); } } if (!candidates.isEmpty()) { additionalRefresh.add(wiring.getBundle()); break; } } } } } } return additionalRefresh.toArray(new Bundle[additionalRefresh.size()]); } private BundleWiring getHostWiring(BundleWiring wiring) { if ((wiring.getRevision().getTypes() & BundleRevision.TYPE_FRAGMENT) == 0) { // not a fragment return wiring; } Collection hostWires = wiring.getRequiredWires(HostNamespace.HOST_NAMESPACE); // just use the first host wiring if (hostWires.isEmpty()) { return wiring; } BundleWire hostWire = hostWires.iterator().next(); return hostWire.getProviderWiring(); } private Set getResolvedBundles() { Set resolved = new HashSet<>(); Bundle[] allBundles = manipulatingContext.getBundles(); for (Bundle bundle : allBundles) if ((bundle.getState() & (Bundle.INSTALLED | Bundle.UNINSTALLED)) == 0) resolved.add(bundle); return resolved; } private Collection uninstallBundles(HashSet toUninstall) { Collection removedBundles = new ArrayList<>(toUninstall.size()); for (BundleInfo current : toUninstall) { Bundle[] matchingBundles = packageAdminService.getBundles(current.getSymbolicName(), getVersionRange(current.getVersion())); for (int j = 0; matchingBundles != null && j < matchingBundles.length; j++) { try { removedBundles.add(matchingBundles[j]); matchingBundles[j].uninstall(); } catch (BundleException e) { //TODO log in debug mode... } } } return removedBundles; } private void saveStateAsLast(URL url) { File lastBundlesTxt = getLastBundleInfo(); try (OutputStream destinationStream = new FileOutputStream(lastBundlesTxt)) { ArrayList sourcesLocation = SimpleConfiguratorUtils.getInfoFiles(); List sourceStreams = new ArrayList<>(sourcesLocation.size() + 1); sourceStreams.add(url.openStream()); if (Activator.EXTENDED) { for (int i = 0; i < sourcesLocation.size(); i++) { sourceStreams.add(new FileInputStream(sourcesLocation.get(i))); } } SimpleConfiguratorUtils.transferStreams(sourceStreams, destinationStream); } catch (URISyntaxException e) { // nothing, was discovered when starting framework } catch (IOException e) { //nothing } } private File getLastBundleInfo() { return manipulatingContext.getDataFile(LAST_BUNDLES_INFO); } private BundleInfo[] getLastState() { File lastBundlesInfo = getLastBundleInfo(); if (!lastBundlesInfo.isFile()) return null; try { return SimpleConfiguratorUtils.readConfiguration(lastBundlesInfo.toURL(), baseLocation).toArray(new BundleInfo[1]); } catch (IOException e) { return null; } } private ArrayList installBundles(BundleInfo[] finalList, Collection toStart) { ArrayList toRefresh = new ArrayList<>(); String useReferenceProperty = manipulatingContext.getProperty(SimpleConfiguratorConstants.PROP_KEY_USE_REFERENCE); boolean useReference = useReferenceProperty == null ? runningOnEquinox : Boolean.parseBoolean(useReferenceProperty); for (BundleInfo element : finalList) { if (element == null) continue; //TODO here we do not deal with bundles that don't have a symbolic id //TODO Need to handle the case where getBundles return multiple value String symbolicName = element.getSymbolicName(); String version = element.getVersion(); Bundle[] matches = null; if (symbolicName != null && version != null) matches = packageAdminService.getBundles(symbolicName, getVersionRange(version)); String bundleLocation = SimpleConfiguratorUtils.getBundleLocation(element, useReference); Bundle current = matches == null ? null : (matches.length == 0 ? null : matches[0]); if (current == null) { try { current = manipulatingContext.installBundle(bundleLocation); if (symbolicName != null && version != null) { Version v; try { v = new Version(version); if (!symbolicName.equals(current.getSymbolicName()) || !v.equals(current.getVersion())) { // can happen if, for example, the new version of the bundle is installed // to the same bundle location as the old version current.update(); } } catch (IllegalArgumentException e) { // invalid version string; should log if (Activator.DEBUG) e.printStackTrace(); } } if (Activator.DEBUG) System.out.println("installed bundle:" + element); //$NON-NLS-1$ toRefresh.add(current); } catch (BundleException e) { if (Activator.DEBUG) { System.err.println("Can't install " + symbolicName + '/' + version + " from location " + element.getLocation()); //$NON-NLS-1$ //$NON-NLS-2$ e.printStackTrace(); } continue; } } else if (inDevMode && current.getBundleId() != 0 && current != manipulatingContext.getBundle() && !bundleLocation.equals(current.getLocation()) && !current.getLocation().startsWith("initial@")) { // We do not do this for the system bundle (id==0), the manipulating bundle or any bundle installed from the osgi.bundles list (locations starting with "@initial" // The bundle exists; but the location is different. Uninstall the current and install the new one (bug 229700) try { current.uninstall(); toRefresh.add(current); } catch (BundleException e) { if (Activator.DEBUG) { System.err.println("Can't uninstall " + symbolicName + '/' + version + " from location " + current.getLocation()); //$NON-NLS-1$ //$NON-NLS-2$ e.printStackTrace(); } continue; } try { current = manipulatingContext.installBundle(bundleLocation); if (Activator.DEBUG) System.out.println("installed bundle:" + element); //$NON-NLS-1$ toRefresh.add(current); } catch (BundleException e) { if (Activator.DEBUG) { System.err.println("Can't install " + symbolicName + '/' + version + " from location " + element.getLocation()); //$NON-NLS-1$ //$NON-NLS-2$ e.printStackTrace(); } continue; } } // Mark Started if (element.isMarkedAsStarted()) { toStart.add(current); } // Set Start Level int startLevel = element.getStartLevel(); if (startLevel < 1) continue; if (current.getBundleId() == 0) continue; if (packageAdminService.getBundleType(current) == PackageAdmin.BUNDLE_TYPE_FRAGMENT) continue; if (SimpleConfiguratorConstants.TARGET_CONFIGURATOR_NAME.equals(current.getSymbolicName())) continue; try { startLevelService.setBundleStartLevel(current, startLevel); } catch (IllegalArgumentException ex) { Utils.log(4, null, null, "Failed to set start level of Bundle:" + element, ex); //$NON-NLS-1$ } } return toRefresh; } private void refreshPackages(Bundle[] bundles, BundleContext context) { if (bundles.length == 0 || packageAdminService == null) return; // Prior to Luna the Equinox framework would refresh all bundles with the same // BSN automatically. This is no longer the case for Luna or other framework // implementations. Here we want to make sure all existing bundles with the // same BSN are refreshed also. Set allSameBSNs = new LinkedHashSet<>(); // maintain order and avoid duplicates for (Bundle bundle : bundles) { allSameBSNs.add(bundle); String bsn = bundle.getSymbolicName(); if (bsn != null) { // look for others with same BSN Bundle[] sameBSNs = packageAdminService.getBundles(bsn, null); if (sameBSNs != null) { // likely contains the bundle we just added above but a set is used allSameBSNs.addAll(Arrays.asList(sameBSNs)); } } } CountDownLatch latch = new CountDownLatch(1); FrameworkListener listener = event -> { if (event.getType() == FrameworkEvent.PACKAGES_REFRESHED) { latch.countDown(); } }; context.addFrameworkListener(listener); packageAdminService.refreshPackages(allSameBSNs.toArray(new Bundle[0])); try { latch.await(); } catch (InterruptedException e) { // ignore } // if (DEBUG) { // for (int i = 0; i < bundles.length; i++) { // System.out.println(SimpleConfiguratorUtils.getBundleStateString(bundles[i])); // } // } context.removeFrameworkListener(listener); } private void startBundles(Bundle[] bundles) { for (Bundle bundle : bundles) { if (bundle.getState() == Bundle.UNINSTALLED) { System.err.println("Could not start: " + bundle.getSymbolicName() + '(' + bundle.getLocation() + ':' + bundle.getBundleId() + ')' + ". It's state is uninstalled."); continue; } if (bundle.getState() == Bundle.STARTING && (bundle == callingBundle || bundle == manipulatingContext.getBundle())) continue; if (packageAdminService.getBundleType(bundle) == PackageAdmin.BUNDLE_TYPE_FRAGMENT) continue; if (bundle.getBundleId() == 0) continue; try { bundle.start(); if (Activator.DEBUG) System.out.println("started Bundle:" + bundle.getSymbolicName() + '(' + bundle.getLocation() + ':' + bundle.getBundleId() + ')'); //$NON-NLS-1$ } catch (BundleException e) { e.printStackTrace(); // FrameworkLogEntry entry = new FrameworkLogEntry(FrameworkAdaptor.FRAMEWORK_SYMBOLICNAME, NLS.bind(EclipseAdaptorMsg.ECLIPSE_STARTUP_FAILED_START, bundle.getLocation()), 0, e, null); // log.log(entry); } } } /** * Uninstall bundles which are not listed on finalList. * * @param finalList bundles list not to be uninstalled. * @param packageAdmin package admin service. * @return Collection HashSet of bundles finally installed. */ private Collection uninstallBundles(BundleInfo[] finalList, PackageAdmin packageAdmin) { Bundle[] allBundles = manipulatingContext.getBundles(); //Build a set with all the bundles from the system Set removedBundles = new HashSet<>(allBundles.length); // configurator.setPrerequisiteBundles(allBundles); for (Bundle allBundle : allBundles) { if (allBundle.getBundleId() == 0) { continue; } removedBundles.add(allBundle); } //Remove all the bundles appearing in the final list from the set of installed bundles for (BundleInfo element : finalList) { if (element == null) continue; Bundle[] toAdd = packageAdmin.getBundles(element.getSymbolicName(), getVersionRange(element.getVersion())); for (int j = 0; toAdd != null && j < toAdd.length; j++) { removedBundles.remove(toAdd[j]); } } for (Iterator iter = removedBundles.iterator(); iter.hasNext();) { try { Bundle bundle = iter.next(); if (bundle.getLocation().startsWith("initial@")) { if (Activator.DEBUG) System.out.println("Simple configurator thinks a bundle installed by the boot strap should be uninstalled:" + bundle.getSymbolicName() + '(' + bundle.getLocation() + ':' + bundle.getBundleId() + ')'); //$NON-NLS-1$ // Avoid uninstalling bundles that the boot strap code thinks should be installed (bug 232191) iter.remove(); continue; } bundle.uninstall(); if (Activator.DEBUG) System.out.println("uninstalled Bundle:" + bundle.getSymbolicName() + '(' + bundle.getLocation() + ':' + bundle.getBundleId() + ')'); //$NON-NLS-1$ } catch (BundleException e) { // TODO Auto-generated catch block e.printStackTrace(); } } return removedBundles; } private String getVersionRange(String version) { return version == null ? null : new StringBuilder().append('[').append(version).append(',').append(version).append(']').toString(); } }