Felix-2.0.2-src

/* * Licensed to the Apache Software Foundation (ASF) under one * or more contributor license agreements. See the NOTICE file * distributed with this work for additional information * regarding copyright ownership. The ASF licenses this file * to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance * with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, * software distributed under the License is distributed on an * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY * KIND, either express or implied. See the License for the * specific language governing permissions and limitations * under the License. */ package org.apache.felix.framework; import org.osgi.framework.launch.Framework; import java.io.*; import java.net.*; import java.security.*; import java.util.*; import org.apache.felix.framework.cache.*; import org.apache.felix.framework.ext.SecurityProvider; import org.apache.felix.framework.searchpolicy.*; import org.apache.felix.framework.ServiceRegistry.ServiceRegistryCallbacks; import org.apache.felix.framework.util.*; import org.apache.felix.framework.util.manifestparser.*; import org.apache.felix.moduleloader.*; import org.osgi.framework.*; import org.osgi.framework.BundleReference; import org.osgi.framework.hooks.service.*; import org.osgi.service.packageadmin.ExportedPackage; import org.osgi.service.startlevel.StartLevel; public class Felix extends BundleImpl implements Framework { // The secure action used to do privileged calls static final SecureAction m_secureAction = new SecureAction(); // The extension manager to handle extension bundles ExtensionManager m_extensionManager; // Logging related member variables. private final Logger m_logger; // Immutable config properties. private final Map m_configMap; // Mutable configuration properties passed into constructor. private final Map m_configMutableMap; // MODULE FACTORY. private final FelixResolverState m_resolverState; private final FelixResolver m_felixResolver; // Lock object used to determine if an individual bundle // lock or the global lock can be acquired. private final Object[] m_bundleLock = new Object[0]; // Keeps track of threads wanting to acquire the global lock. private final List m_globalLockWaitersList = new ArrayList(); // The thread currently holding the global lock. private Thread m_globalLockThread = null; // How many times the global lock was acquired by the thread holding // the global lock; if this value is zero, then it means the global // lock is free. private int m_globalLockCount = 0; // Maps a bundle location to a bundle location; // used to reserve a location when installing a bundle. private final Map m_installRequestMap = new HashMap(); // This lock must be acquired to modify m_installRequestMap; // to help avoid deadlock this lock as priority 1 and should // be acquired before locks with lower priority. private final Object[] m_installRequestLock_Priority1 = new Object[0]; // Maps a bundle location to a bundle. private HashMap m_installedBundleMap; private SortedMap m_installedBundleIndex; // This lock must be acquired to modify m_installedBundleMap; // to help avoid deadlock this lock as priority 2 and should // be acquired before locks with lower priority. private final Object[] m_installedBundleLock_Priority2 = new Object[0]; // An array of uninstalled bundles before a refresh occurs. private BundleImpl[] m_uninstalledBundles = null; // This lock must be acquired to modify m_uninstalledBundles; // to help avoid deadlock this lock as priority 3 and should // be acquired before locks with lower priority. private final Object[] m_uninstalledBundlesLock_Priority3 = new Object[0]; // Framework's active start level. private volatile int m_activeStartLevel = FelixConstants.FRAMEWORK_INACTIVE_STARTLEVEL; // Local bundle cache. private BundleCache m_cache = null; // System bundle activator list. List m_activatorList = null; // Next available bundle identifier. private long m_nextId = 1L; private final Object m_nextIdLock = new Object[0]; // List of event listeners. private EventDispatcher m_dispatcher = null; // Service registry. private ServiceRegistry m_registry = null; // Reusable bundle URL stream handler. private final URLStreamHandler m_bundleStreamHandler; // Boot package delegation. private final String[] m_bootPkgs; private final boolean[] m_bootPkgWildcards; // Shutdown thread. private Thread m_shutdownThread = null; private volatile ThreadGate m_shutdownGate = null; /** * <p> * This constructor creates a framework instance with a specified <tt>Map</tt> * of configuration properties. Configuration properties are used internally * by the framework to alter its default behavior. The configuration properties * should have a <tt>String</tt> key and an <tt>Object</tt> value. The passed * in <tt>Map</tt> is copied by the framework and all keys are converted to * <tt>String</tt>s. * </p> * <p> * Configuration properties are generally the sole means to configure the * framework's default behavior; the framework does not typically refer to * any system properties for configuration information. If a <tt>Map</tt> is * supplied to this method for configuration properties, then the framework * will consult the <tt>Map</tt> instance for any and all configuration * properties. It is possible to specify a <tt>null</tt> for the configuration * property map, in which case the framework will use its default behavior * in all cases. * </p> * <p> * The following configuration properties can be specified (properties starting * with "<tt>felix</tt>" are specific to Felix, while those starting with * "<tt>org.osgi</tt>" are standard OSGi properties): * </p> * <ul> * <li><tt>org.osgi.framework.storage</tt> - Sets the directory to use as * the bundle cache; by default bundle cache directory is * <tt>felix-cache</tt> in the current working directory. The value * should be a valid directory name. The directory name can be either absolute * or relative. Relative directory names are relative to the current working * directory. The specified directory will be created if it does * not exist. * </li> * <li><tt>org.osgi.framework.storage.clean</tt> - Determines whether the * bundle cache is flushed. The value can either be "<tt>none</tt>" * or "<tt>onFirstInit</tt>", where "<tt>none</tt>" does not flush * the bundle cache and "<tt>onFirstInit</tt>" flushes the bundle * cache when the framework instance is first initialized. The default * value is "<tt>none</tt>". * </li> * <li><tt>felix.cache.rootdir</tt> - Sets the root directory to use to * calculate the bundle cache directory for relative directory names. If * <tt>org.osgi.framework.storage</tt> is set to a relative name, by * default it is relative to the current working directory. If this * property is set, then it will be calculated as being relative to * the specified root directory. * </li> * <li><tt>felix.cache.bufsize</tt> - Sets the buffer size to be used by * the cache; the default value is 4096. The integer value of this * string provides control over the size of the internal buffer of the * disk cache for performance reasons. * </li> * <li><tt>org.osgi.framework.syst