/*
* 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 java.util.ArrayList;
import java.util.Collection;
import java.util.List;
import org.osgi.framework.AdminPermission;
import org.osgi.framework.Bundle;
import org.osgi.framework.BundleContext;
import org.osgi.framework.FrameworkListener;
import org.osgi.framework.ServiceRegistration;
import org.osgi.framework.wiring.BundleCapability;
import org.osgi.framework.wiring.FrameworkWiring;
import org.osgi.resource.Requirement;
import org.osgi.service.packageadmin.PackageAdmin;
class FrameworkWiringImpl implements FrameworkWiring, Runnable
{
private final Felix m_felix;
private final ServiceRegistry m_registry;
private final List<Collection<Bundle>> m_requests = new ArrayList();
private final List<FrameworkListener[]> m_requestListeners
= new ArrayList<FrameworkListener[]>();
private ServiceRegistration<PackageAdmin> m_paReg;
private Thread m_thread = null;
public FrameworkWiringImpl(Felix felix, ServiceRegistry registry)
{
m_felix = felix;
m_registry = registry;
}
@SuppressWarnings("unchecked")
void start()
{
m_paReg = (ServiceRegistration<PackageAdmin>) m_registry.registerService(m_felix._getBundleContext(),
new String[] { PackageAdmin.class.getName() },
new PackageAdminImpl(m_felix),
null);
}
/**
* Stops the FelixFrameworkWiring thread on system shutdown. Shutting down the
* thread explicitly is required in the embedded case, where Felix may be
* stopped without the Java VM being stopped. In this case the
* FelixFrameworkWiring thread must be stopped explicitly.
* <p>
* This method is called by the
* {@link PackageAdminActivator#stop(BundleContext)} method.
*/
void stop()
{
synchronized (m_requests)
{
if (m_thread != null)
{
// Null thread variable to signal to the thread that
// we want it to exit.
m_thread = null;
// Wake up the thread, if it is currently in the wait() state
// for more work.
m_requests.notifyAll();
}
}
}
public Bundle getBundle()
{
return m_felix;
}
public void refreshBundles(Collection<Bundle> bundles, FrameworkListener... listeners)
{
Object sm = System.getSecurityManager();
if (sm != null)
{
((SecurityManager) sm).checkPermission(
new AdminPermission(m_felix, AdminPermission.RESOLVE));
}
synchronized (m_requests)
{
// Start a thread to perform asynchronous package refreshes.
if (m_thread == null)
{
m_thread = new Thread(this, "FelixFrameworkWiring");
m_thread.setDaemon(true);
m_thread.start();
}
// Queue request and notify thread.
m_requests.add(bundles);
m_requestListeners.add(listeners);
m_requests.notifyAll();
}
}
public boolean resolveBundles(Collection<Bundle> bundles)
{
Object sm = System.getSecurityManager();
if (sm != null)
{
((SecurityManager) sm).checkPermission(
new AdminPermission(m_felix, AdminPermission.RESOLVE));
}
return m_felix.resolveBundles(bundles);
}
public Collection<Bundle> getRemovalPendingBundles()
{
return m_felix.getRemovalPendingBundles();
}
public Collection<Bundle> getDependencyClosure(Collection<Bundle> targets)
{
return m_felix.getDependencyClosure(targets);
}
/**
* The OSGi specification states that package refreshes happen
* asynchronously; this is the run() method for the package
* refreshing thread.
**/
public void run()
{
// This thread loops forever, thus it should
// be a daemon thread.
while (true)
{
Collection<Bundle> bundles = null;
FrameworkListener[] listeners = null;
synchronized (m_requests)
{
// Wait for a refresh request.
while (m_requests.isEmpty())
{
// Terminate the thread if requested to do so (see stop()).
if (m_thread == null)
{
return;
}
try
{
m_requests.wait();
}
catch (InterruptedException ex)
{
}
}
// Get the bundles parameter for the current refresh request.
bundles = m_requests.get(0);
listeners = m_requestListeners.get(0);
}
// Perform refresh.
// NOTE: We don't catch any exceptions here, because
// the invoked method shields us from exceptions by
// catching Throwables when its invokes callbacks.
m_felix.refreshPackages(bundles, listeners);
// Remove the first request since it is now completed.
synchronized (m_requests)
{
m_requests.remove(0);
m_requestListeners.remove(0);
}
}
}
/* (non-Javadoc)
* @see org.osgi.framework.wiring.FrameworkWiring#findProviders(org.osgi.resource.Requirement)
*/
public Collection<BundleCapability> findProviders(Requirement requirement) {
throw new UnsupportedOperationException(); // TODO
}
}