org.ops4j.pax.swissbox.core

Class BundleUtils

java.lang.Object

org.ops4j.pax.swissbox.core.BundleUtils

public class BundleUtils
extends Object

Utilities related to bundles.

Since:

0.1.0, January 11, 2008

Author:

Alin Dreghiciu, Harald Wellmann

Constructor Summary

Constructors

Constructor and Description
BundleUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static org.osgi.framework.Bundle	getBundle(org.osgi.framework.BundleContext bc, String symbolicName) Returns any bundle with the given symbolic name, or null if no such bundle exists.
static org.osgi.framework.Bundle	getBundle(org.osgi.framework.BundleContext bc, String symbolicName, String version) Returns the bundle with the given symbolic name and the given version, or null if no such bundle exists
static org.osgi.framework.BundleContext	getBundleContext(org.osgi.framework.Bundle bundle) Discovers the bundle context for a bundle.
static List<org.osgi.framework.Bundle>	getBundles(org.osgi.framework.BundleContext bc, String symbolicName) Returns a list of all bundles with the given symbolic name.

Methods inherited from class java.lang.Object

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

Constructor Detail

BundleUtils

public BundleUtils()

Method Detail

getBundleContext

public static org.osgi.framework.BundleContext getBundleContext(org.osgi.framework.Bundle bundle)

Discovers the bundle context for a bundle. If the bundle is an 4.1.0 or greater bundle it should have a method that just returns the bundle context. Otherwise uses reflection to look for an internal bundle context.

Parameters:

bundle - the bundle from which the bundle context is needed

Returns:

corresponding bundle context or null if bundle context cannot be discovered

getBundle

public static org.osgi.framework.Bundle getBundle(org.osgi.framework.BundleContext bc,
                                  String symbolicName)

Returns any bundle with the given symbolic name, or null if no such bundle exists. If there are multiple bundles with the same symbolic name and different version, this method returns the first bundle found.

Parameters:

bc - bundle context

symbolicName - bundle symbolic name

version - bundle version

Returns:

matching bundle, or null

getBundles

public static List<org.osgi.framework.Bundle> getBundles(org.osgi.framework.BundleContext bc,
                                         String symbolicName)

Returns a list of all bundles with the given symbolic name.

Parameters:

bc - bundle context

symbolicName - bundle symbolic name

Returns:

matching bundles. The list may be empty, but never null.

getBundle

public static org.osgi.framework.Bundle getBundle(org.osgi.framework.BundleContext bc,
                                  String symbolicName,
                                  String version)

Returns the bundle with the given symbolic name and the given version, or null if no such bundle exists

Parameters:

bc - bundle context

symbolicName - bundle symbolic name

version - bundle version

Returns:

matching bundle, or null