org.eclipse.gemini.blueprint.util

Class BundleDelegatingClassLoader

java.lang.Object

java.lang.ClassLoader

org.eclipse.gemini.blueprint.util.BundleDelegatingClassLoader

public class BundleDelegatingClassLoader
extends java.lang.ClassLoader

ClassLoader backed by an OSGi bundle. Provides the ability to use a separate class loader as fall back. Contains facilities for tracing class loading behaviour so that issues can be easily resolved. For debugging please see DebugUtils.

Field Summary

Fields

Modifier and Type	Field and Description
private org.osgi.framework.Bundle	backingBundle
private java.lang.ClassLoader	bridge
private static org.apache.commons.logging.Log	log use degradable logger

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	BundleDelegatingClassLoader(org.osgi.framework.Bundle bundle, java.lang.ClassLoader bridgeLoader) Private constructor.

Method Summary

Modifier and Type	Method and Description
static BundleDelegatingClassLoader	createBundleClassLoaderFor(org.osgi.framework.Bundle aBundle) Factory method for creating a class loader over the given bundle.
static BundleDelegatingClassLoader	createBundleClassLoaderFor(org.osgi.framework.Bundle bundle, java.lang.ClassLoader bridge) Factory method for creating a class loader over the given bundle and with a given class loader as fall-back.
protected java.lang.Class<?>	findClass(java.lang.String name)
protected java.net.URL	findResource(java.lang.String name)
protected java.util.Enumeration<java.net.URL>	findResources(java.lang.String name)
org.osgi.framework.Bundle	getBundle() Returns the bundle to which this class loader delegates calls to.
java.net.URL	getResource(java.lang.String name)
protected java.lang.Class<?>	loadClass(java.lang.String name, boolean resolve)
java.lang.String	toString()

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findLibrary, findLoadedClass, findSystemClass, getClassLoadingLock, getPackage, getPackages, getParent, getResourceAsStream, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, registerAsParallelCapable, resolveClass, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

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

Field Detail

log

private static final org.apache.commons.logging.Log log

use degradable logger

bridge

private final java.lang.ClassLoader bridge

backingBundle

private final org.osgi.framework.Bundle backingBundle

Constructor Detail

BundleDelegatingClassLoader

protected BundleDelegatingClassLoader(org.osgi.framework.Bundle bundle,
                                      java.lang.ClassLoader bridgeLoader)

Private constructor. Constructs a new BundleDelegatingClassLoader instance.

Parameters:

bundle -

bridgeLoader -

Method Detail

createBundleClassLoaderFor

public static BundleDelegatingClassLoader createBundleClassLoaderFor(org.osgi.framework.Bundle aBundle)

Factory method for creating a class loader over the given bundle.

Parameters:

aBundle - bundle to use for class loading and resource acquisition

Returns:

class loader adapter over the given bundle

createBundleClassLoaderFor

public static BundleDelegatingClassLoader createBundleClassLoaderFor(org.osgi.framework.Bundle bundle,
                                                                     java.lang.ClassLoader bridge)

Factory method for creating a class loader over the given bundle and with a given class loader as fall-back. In case the bundle cannot find a class or locate a resource, the given class loader will be used as fall back.

Parameters:

bundle - bundle used for class loading and resource acquisition

bridge - class loader used as fall back in case the bundle cannot load a class or find a resource. Can be null

Returns:

class loader adapter over the given bundle and class loader

findClass

protected java.lang.Class<?> findClass(java.lang.String name)
                                throws java.lang.ClassNotFoundException

Overrides:

findClass in class java.lang.ClassLoader

Throws:

java.lang.ClassNotFoundException

findResource

protected java.net.URL findResource(java.lang.String name)

Overrides:

findResource in class java.lang.ClassLoader

findResources

protected java.util.Enumeration<java.net.URL> findResources(java.lang.String name)
                                                     throws java.io.IOException

Overrides:

findResources in class java.lang.ClassLoader

Throws:

java.io.IOException

getResource

public java.net.URL getResource(java.lang.String name)

Overrides:

getResource in class java.lang.ClassLoader

loadClass

protected java.lang.Class<?> loadClass(java.lang.String name,
                                       boolean resolve)
                                throws java.lang.ClassNotFoundException

Overrides:

loadClass in class java.lang.ClassLoader

Throws:

java.lang.ClassNotFoundException

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getBundle

public org.osgi.framework.Bundle getBundle()

Returns the bundle to which this class loader delegates calls to.

Returns:

the backing bundle