org.apache.xbean.classloader

Class JarFileClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

org.apache.xbean.classloader.NamedClassLoader

org.apache.xbean.classloader.MultiParentClassLoader

org.apache.xbean.classloader.JarFileClassLoader

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, DestroyableClassLoader

public class JarFileClassLoader
extends MultiParentClassLoader

The JarFileClassLoader that loads classes and resources from a list of JarFiles. This method is simmilar to URLClassLoader except it properly closes JarFiles when the classloader is destroyed so that the file read lock will be released, and the jar file can be modified and deleted.

Note: This implementation currently does not work reliably on windows, since the jar URL handler included with the Sun JavaVM holds a read lock on the JarFile, and this lock is not released when the jar url is dereferenced. To fix this a replacement for the jar url handler must be written.

Since:

2.0

Version:

$Id: JarFileClassLoader.java 437551 2006-08-28 06:14:47Z adc $

Author:

Dain Sundstrom

Constructor Summary

Constructors

Constructor and Description
JarFileClassLoader(java.lang.String name, java.net.URL[] urls) Creates a JarFileClassLoader that is a child of the system class loader.
JarFileClassLoader(java.lang.String name, java.net.URL[] urls, java.lang.ClassLoader parent) Creates a JarFileClassLoader that is a child of the specified class loader.
JarFileClassLoader(java.lang.String name, java.net.URL[] urls, java.lang.ClassLoader[] parents) Creates a named class loader as a child of the specified parents.
JarFileClassLoader(java.lang.String name, java.net.URL[] urls, java.lang.ClassLoader[] parents, boolean inverseClassLoading, java.util.Collection hiddenClasses, java.util.Collection nonOverridableClasses)
JarFileClassLoader(java.lang.String name, java.net.URL[] urls, java.lang.ClassLoader[] parents, boolean inverseClassLoading, java.lang.String[] hiddenClasses, java.lang.String[] nonOverridableClasses)
JarFileClassLoader(java.lang.String name, java.net.URL[] urls, java.lang.ClassLoader parent, boolean inverseClassLoading, java.lang.String[] hiddenClasses, java.lang.String[] nonOverridableClasses)

Method Summary

Methods

Modifier and Type	Method and Description
void	addURL(java.net.URL url)
protected void	addURLs(java.net.URL[] urls) Adds an array of urls to the end of this class loader.
void	destroy() Destroys the clasloader releasing all resources.
protected java.lang.Class	findClass(java.lang.String className)
protected java.lang.String	findLibrary(java.lang.String libraryName)
java.net.URL	findResource(java.lang.String resourceName)
java.util.Enumeration	findResources(java.lang.String resourceName)
java.net.URL[]	getURLs()

Methods inherited from class org.apache.xbean.classloader.MultiParentClassLoader

getParents, getResource, loadClass, toString

Methods inherited from class org.apache.xbean.classloader.NamedClassLoader

getName, isDestroyed

Methods inherited from class java.net.URLClassLoader

close, definePackage, getPermissions, getResourceAsStream, newInstance, newInstance

Methods inherited from class java.security.SecureClassLoader

defineClass, defineClass

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, 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, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

JarFileClassLoader

public JarFileClassLoader(java.lang.String name,
                  java.net.URL[] urls)

Creates a JarFileClassLoader that is a child of the system class loader.

Parameters:

name - the name of this class loader

urls - a list of URLs from which classes and resources should be loaded

JarFileClassLoader

public JarFileClassLoader(java.lang.String name,
                  java.net.URL[] urls,
                  java.lang.ClassLoader parent)

Creates a JarFileClassLoader that is a child of the specified class loader.

Parameters:

name - the name of this class loader

urls - a list of URLs from which classes and resources should be loaded

parent - the parent of this class loader

JarFileClassLoader

public JarFileClassLoader(java.lang.String name,
                  java.net.URL[] urls,
                  java.lang.ClassLoader parent,
                  boolean inverseClassLoading,
                  java.lang.String[] hiddenClasses,
                  java.lang.String[] nonOverridableClasses)

JarFileClassLoader

public JarFileClassLoader(java.lang.String name,
                  java.net.URL[] urls,
                  java.lang.ClassLoader[] parents)

Creates a named class loader as a child of the specified parents.

Parameters:

name - the name of this class loader

urls - the urls from which this class loader will classes and resources

parents - the parents of this class loader

JarFileClassLoader

public JarFileClassLoader(java.lang.String name,
                  java.net.URL[] urls,
                  java.lang.ClassLoader[] parents,
                  boolean inverseClassLoading,
                  java.util.Collection hiddenClasses,
                  java.util.Collection nonOverridableClasses)

JarFileClassLoader

public JarFileClassLoader(java.lang.String name,
                  java.net.URL[] urls,
                  java.lang.ClassLoader[] parents,
                  boolean inverseClassLoading,
                  java.lang.String[] hiddenClasses,
                  java.lang.String[] nonOverridableClasses)

Method Detail

getURLs

public java.net.URL[] getURLs()

Overrides:

getURLs in class java.net.URLClassLoader

addURL

public void addURL(java.net.URL url)

Overrides:

addURL in class java.net.URLClassLoader

addURLs

protected void addURLs(java.net.URL[] urls)

Adds an array of urls to the end of this class loader.

Parameters:

urls - the URLs to add

destroy

public void destroy()

Destroys the clasloader releasing all resources. After this mehtod is called, the class loader will no longer load any classes or resources.

Specified by:

destroy in interface DestroyableClassLoader

Overrides:

destroy in class NamedClassLoader

findResource

public java.net.URL findResource(java.lang.String resourceName)

Overrides:

findResource in class java.net.URLClassLoader

findResources

public java.util.Enumeration findResources(java.lang.String resourceName)
                                    throws java.io.IOException

Overrides:

findResources in class MultiParentClassLoader

Throws:

java.io.IOException

findLibrary

protected java.lang.String findLibrary(java.lang.String libraryName)

Overrides:

findLibrary in class java.lang.ClassLoader

findClass

protected java.lang.Class findClass(java.lang.String className)
                             throws java.lang.ClassNotFoundException

Overrides:

findClass in class java.net.URLClassLoader

Throws:

java.lang.ClassNotFoundException