Package org.eclipse.jetty.osgi.util

Class BundleDelegatingClassLoader

java.lang.Object

java.lang.ClassLoader

org.eclipse.jetty.osgi.util.BundleDelegatingClassLoader

All Implemented Interfaces:

org.osgi.framework.BundleReference

public class BundleDelegatingClassLoader
extends ClassLoader
implements org.osgi.framework.BundleReference

BundleDelegatingClassLoader

A ClassLoader that delegates to an OSGi Bundle using the standard OSGi specification API methods (Bundle.loadClass, Bundle.getResource, Bundle.getResources) instead of using reflection to access internal container-specific classloaders.

When the first class is loaded, this classloader obtains the real bundle classloader from that class and delegates to it for subsequent operations, providing better compatibility and performance for classloader-specific operations.

Constructor Summary

Constructors

Constructor	Description
BundleDelegatingClassLoader(org.osgi.framework.Bundle bundle)	Creates a new BundleDelegatingClassLoader for the given bundle.

Method Summary

Modifier and Type	Method	Description
org.osgi.framework.Bundle	getBundle()
ClassLoader	getBundleClassLoader()	Gets the underlying bundle classloader if one has been resolved, or null if no class has been loaded yet.
URL	getResource(String name)
InputStream	getResourceAsStream(String name)
Enumeration<URL>	getResources(String name)
Class<?>	loadClass(String name)
protected Class<?>	loadClass(String name, boolean resolve)
String	toString()

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findClass, findClass, findLibrary, findLoadedClass, findResource, findResource, findResources, findSystemClass, getClassLoadingLock, getDefinedPackage, getDefinedPackages, getName, getPackage, getPackages, getParent, getPlatformClassLoader, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, getUnnamedModule, isRegisteredAsParallelCapable, registerAsParallelCapable, resolveClass, resources, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

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

Constructor Details

BundleDelegatingClassLoader

public BundleDelegatingClassLoader(org.osgi.framework.Bundle bundle)

Creates a new BundleDelegatingClassLoader for the given bundle.

Parameters:

bundle - the OSGi bundle to delegate class and resource loading to

Method Details

getBundle

public org.osgi.framework.Bundle getBundle()

Specified by:

getBundle in interface org.osgi.framework.BundleReference

loadClass

public Class<?> loadClass(String name)
                   throws ClassNotFoundException

Overrides:

loadClass in class ClassLoader

Throws:

ClassNotFoundException

loadClass

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

Overrides:

loadClass in class ClassLoader

Throws:

ClassNotFoundException

getResource

public URL getResource(String name)

Overrides:

getResource in class ClassLoader

getResources

public Enumeration<URL> getResources(String name)
                              throws IOException

Overrides:

getResources in class ClassLoader

Throws:

IOException

getResourceAsStream

public InputStream getResourceAsStream(String name)

Overrides:

getResourceAsStream in class ClassLoader

getBundleClassLoader

public ClassLoader getBundleClassLoader()

Gets the underlying bundle classloader if one has been resolved, or null if no class has been loaded yet.

Returns:

the resolved bundle classloader, or null

toString

public String toString()

Overrides:

toString in class Object