org.apache.xbean.osgi.bundle.util.equinox

Class EquinoxBundleClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

org.apache.xbean.osgi.bundle.util.equinox.EquinoxBundleClassLoader

All Implemented Interfaces:

Closeable, AutoCloseable, DelegatingBundleReference, org.osgi.framework.BundleReference

public class EquinoxBundleClassLoader
extends URLClassLoader
implements DelegatingBundleReference

ClassLoader for a Bundle.
This ClassLoader implementation extends the URLClassLoader and converts resource "bundle" URLs (found in directories or embedded jar files) into regular jar URLs. This ClassLoader implementation will only work on Equinox framework.

Version:

$Rev: 1163514 $ $Date: 2011-08-31 00:37:38 -0700 (Wed, 31 Aug 2011) $

Constructor Summary

Constructors

Constructor and Description
EquinoxBundleClassLoader(org.osgi.framework.Bundle bundle)
EquinoxBundleClassLoader(org.osgi.framework.Bundle bundle, boolean searchWiredBundles, boolean convertResourceUrls)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object other)
Enumeration<URL>	findResources(String name)
org.osgi.framework.Bundle	getBundle() Return the bundle associated with this classloader.
org.osgi.framework.Bundle	getBundle(boolean unwrap) Return the bundle associated with this classloader.
boolean	getConvertResourceUrls()
URL	getResource(String name)
boolean	getSearchWiredBundles()
int	hashCode()
protected Class<?>	loadClass(String name, boolean resolve)
void	setConvertResourceUrls(boolean convert)
void	setSearchWiredBundles(boolean search)
String	toString()

Methods inherited from class java.net.URLClassLoader

addURL, close, definePackage, findClass, findResource, getPermissions, getResourceAsStream, getURLs, newInstance, newInstance

Methods inherited from class java.security.SecureClassLoader

defineClass, defineClass

Methods inherited from class java.lang.ClassLoader

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

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

EquinoxBundleClassLoader

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

EquinoxBundleClassLoader

public EquinoxBundleClassLoader(org.osgi.framework.Bundle bundle,
                        boolean searchWiredBundles,
                        boolean convertResourceUrls)

Method Detail

toString

public String toString()

Overrides:

toString in class Object

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

findResources

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

Overrides:

findResources in class URLClassLoader

Throws:

IOException

setSearchWiredBundles

public void setSearchWiredBundles(boolean search)

getSearchWiredBundles

public boolean getSearchWiredBundles()

setConvertResourceUrls

public void setConvertResourceUrls(boolean convert)

getConvertResourceUrls

public boolean getConvertResourceUrls()

getBundle

public org.osgi.framework.Bundle getBundle(boolean unwrap)

Return the bundle associated with this classloader. In most cases the bundle associated with the classloader is a regular framework bundle. However, in some cases the bundle associated with the classloader is a DelegatingBundle. In such cases, the unwrap parameter controls whether this function returns the DelegatingBundle instance or the main application bundle backing with the DelegatingBundle.

Specified by:

getBundle in interface DelegatingBundleReference

Parameters:

unwrap - If true and if the bundle associated with this classloader is a DelegatingBundle, this function will return the main application bundle backing with the DelegatingBundle. Otherwise, the bundle associated with this classloader is returned as is.

Returns:

The bundle associated with this classloader.

getBundle

public org.osgi.framework.Bundle getBundle()

Return the bundle associated with this classloader. This method calls getBundle(true) and therefore always returns a regular framework bundle.

Note: Some libraries use BundleReference.getBundle() to obtain a bundle for the given classloader and expect the returned bundle instance to be work with any OSGi API. Some of these API might not work if DelegatingBundle is returned. That is why this function will always return a regular framework bundle. See getBundle(boolean) for more information.

Specified by:

getBundle in interface org.osgi.framework.BundleReference

Returns:

The bundle associated with this classloader.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object other)

Overrides:

equals in class Object