com.compoundtheory.classloader
Class NetworkClassLoader

java.lang.Object
  java.lang.ClassLoader
      com.compoundtheory.classloader.NetworkClassLoader

public class NetworkClassLoader
extends java.lang.ClassLoader

The correct name for this class should be URLClassLoader. But there is already a class by that name in JDK1.2. I have had quite a few problems with URLClassLoader in past, so I ended up writing this ClassLoader. I found that the Java 2's URLClassLoader, does not close the Jar file once opened. It is a pretty good optimization step, but if you modify the class in the jar file, it does not pick it up. Some operating systems may not let you modify the jar file while it is still open. IMHO, it does make sense to close the jar file after you are done reading the class data. But this approach may not get you the performance of the URLClassLoader, but it works in all cases and also runs on JDK1.1. I have enhanced this class loader to read all the zip/jar entries once & cache the data, so that there is no overhead of opening/closing jar file to pick up each entry.

Modified and enhanced by Mark Mandel to work specifically with ColdFusion, in specific contexts.

Author:

Harish Prabandham

Constructor Summary

NetworkClassLoader()

NetworkClassLoader(java.lang.ClassLoader parent)
Creates a new instance of the class loader.

Method Summary

void	addURL(java.net.URL url) Adds the given URL to this class loader.
void	clear() This method resets this ClassLoader's state.
protected void	finalize() This method resets this ClassLoader's state and resets the references for garbage collection.
java.lang.Class	findClass(java.lang.String name) Call this to bypass the implementation of loadClass.
protected java.net.URL	findResource(java.lang.String name) Overridden to search for a resource and return a "jar"-style URL or normal "file" URL as necessary.
protected java.util.Enumeration	findResources(java.lang.String name) Find all resources for a given name
java.io.InputStream	getResourceAsStream(java.lang.String name)
java.net.URL[]	getURLs()
java.lang.Class	loadClass(java.lang.String name, boolean resolve) Load a class for given name
protected byte[]	loadClassData(java.lang.String classname)
protected byte[]	loadResource(java.lang.String resource)
protected byte[]	loadResource(java.net.URL url, java.lang.String resourceName)
protected void	setParent(java.lang.ClassLoader parent) Sets the parent/delegate class loader.

Methods inherited from class java.lang.ClassLoader

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

Methods inherited from class java.lang.Object

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

Constructor Detail

NetworkClassLoader

public NetworkClassLoader()

NetworkClassLoader

public NetworkClassLoader(java.lang.ClassLoader parent)

Creates a new instance of the class loader.

Parameters:

delegate - /parent class loader.

Method Detail

setParent

protected final void setParent(java.lang.ClassLoader parent)

Sets the parent/delegate class loader.

Parameters:

delegate - /parent class loader.

addURL

public void addURL(java.net.URL url)

Adds the given URL to this class loader. If the URL ends with "/", then it is assumed to be a directory otherwise, it is assumed to be a zip/jar file. If the same URL is added again, the URL is re-opened and this zip/jar file is used for serving any future class requests.

Parameters:

URL - where to look for the classes.

getURLs

public java.net.URL[] getURLs()

Returns:

An enumeration of URLs where this class loader looks for classes.

findClass

public java.lang.Class findClass(java.lang.String name)
                          throws java.lang.ClassNotFoundException

Call this to bypass the implementation of loadClass.

Overrides:

findClass in class java.lang.ClassLoader

Throws:

java.lang.ClassNotFoundException

loadResource

protected byte[] loadResource(java.net.URL url,
                              java.lang.String resourceName)
                       throws java.io.IOException

Throws:

java.io.IOException

loadResource

protected byte[] loadResource(java.lang.String resource)

loadClassData

protected byte[] loadClassData(java.lang.String classname)

findResource

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

Overridden to search for a resource and return a "jar"-style URL or normal "file" URL as necessary.

Overrides:

findResource in class java.lang.ClassLoader

findResources

protected java.util.Enumeration findResources(java.lang.String name)
                                       throws java.io.IOException

Find all resources for a given name

Overrides:

findResources in class java.lang.ClassLoader

Returns:

an enumeration of all the resources found.

Throws:

java.io.IOException

getResourceAsStream

public java.io.InputStream getResourceAsStream(java.lang.String name)

Overrides:

getResourceAsStream in class java.lang.ClassLoader

Returns:

The resource as the input stream if such a resource exists, otherwise returns null.

loadClass

public java.lang.Class loadClass(java.lang.String name,
                                 boolean resolve)
                          throws java.lang.ClassNotFoundException

Load a class for given name

Overrides:

loadClass in class java.lang.ClassLoader

Throws:

java.lang.ClassNotFoundException

clear

public final void clear()

This method resets this ClassLoader's state. It completely removes all the URLs and classes in this class loader cache.

finalize

protected void finalize()
                 throws java.lang.Throwable

This method resets this ClassLoader's state and resets the references for garbage collection.

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable