org.codehaus.classworlds
Class UberJarRealmClassLoader

java.lang.Object
  java.lang.ClassLoader
      java.security.SecureClassLoader
          java.net.URLClassLoader
              org.codehaus.classworlds.UberJarRealmClassLoader

public class UberJarRealmClassLoader
extends URLClassLoader

Classloader for ClassRealms.

Loads classes from an "uberjar".

Version:

$Id: UberJarRealmClassLoader.java 126 2006-01-12 04:17:51Z $

Author:

bob mcwhirter

Field Summary

protected DefaultClassRealm

realm The realm.

Constructor Summary

UberJarRealmClassLoader(DefaultClassRealm realm)

Method Summary

void	addConstituent(URL constituent) Add a constituent to this realm for locating classes.
protected byte[]	findClassInDirectoryUrl(URL url, String path)
protected byte[]	findClassInJarStream(URL inUrl, String path)
URL	findResource(String name) Find a resource within this ClassLoader only (don't delegate to the parent).
protected URL	findResourceInDirectoryUrl(URL inUrl, String path)
protected URL	findResourceInJarStream(URL inUrl, String path)
Enumeration	findResources(String name)
Enumeration	findResourcesDirect(String name) Find resources from this ClassLoader, and don't search the realm.
byte[]	getBytesToEndOfStream(DataInputStream in) Helper method for addConstituent that reads in a DataInputStream and returns it as a byte[] It attempts to use in.available - the size of the file - else defaults to 2048
URL	getResource(String name)
URL	getResourceDirect(String name) Get a resource from this ClassLoader, and don't search the realm.
URL[]	getURLs() Retrieve the URLs used by this ClassLoader.
protected Class	loadClass(String name, boolean resolve) Load a class.
Class	loadClassDirect(String className) Load a class directly from this classloader without defering through any other ClassRealm.

Methods inherited from class java.net.URLClassLoader

addURL, definePackage, findClass, getPermissions, 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, getPackage, getPackages, getParent, getResourceAsStream, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, resolveClass, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

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

Field Detail

realm

protected DefaultClassRealm realm

The realm.

Constructor Detail

UberJarRealmClassLoader

public UberJarRealmClassLoader(DefaultClassRealm realm)

Method Detail

addConstituent

public void addConstituent(URL constituent)

Add a constituent to this realm for locating classes. If the url definition ends in .class its a BytesURLStreamHandler so use defineClass insead. addURL is still called for byte[] even though it has no affect and we use defineClass instead, this is for consistentency and to allow access to the class with getURLs()

Parameters:

constituent - URL to contituent jar or directory.

loadClassDirect

public Class loadClassDirect(String className)
                      throws ClassNotFoundException

Load a class directly from this classloader without defering through any other ClassRealm.

Parameters:

className - The name of the class to load.

Returns:

The loaded class.

Throws:

ClassNotFoundException - If the class could not be found.

findResource

public URL findResource(String name)

Find a resource within this ClassLoader only (don't delegate to the parent).

Returns:

The resource.

findResourcesDirect

public Enumeration findResourcesDirect(String name)

Find resources from this ClassLoader, and don't search the realm. Otherwise we'd recurse indefinitely.

Returns:

The resource.

findResourceInJarStream

protected URL findResourceInJarStream(URL inUrl,
                                      String path)

findResourceInDirectoryUrl

protected URL findResourceInDirectoryUrl(URL inUrl,
                                         String path)

findClassInJarStream

protected byte[] findClassInJarStream(URL inUrl,
                                      String path)

findClassInDirectoryUrl

protected byte[] findClassInDirectoryUrl(URL url,
                                         String path)

getBytesToEndOfStream

public byte[] getBytesToEndOfStream(DataInputStream in)
                             throws IOException

Helper method for addConstituent that reads in a DataInputStream and returns it as a byte[] It attempts to use in.available - the size of the file - else defaults to 2048

Throws:

IOException

loadClass

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

Load a class.

Overrides:

loadClass in class ClassLoader

Parameters:

name - The name of the class to load.

resolve - If true then resolve the class.

Returns:

The loaded class.

Throws:

ClassNotFoundException - If the class cannot be found.

getURLs

public URL[] getURLs()

Retrieve the URLs used by this ClassLoader.

Overrides:

getURLs in class URLClassLoader

Returns:

The urls.

getResource

public URL getResource(String name)

Overrides:

getResource in class ClassLoader

getResourceDirect

public URL getResourceDirect(String name)

Get a resource from this ClassLoader, and don't search the realm. Otherwise we'd recurse indefinitely.

Returns:

The resource.

findResources

public Enumeration findResources(String name)
                          throws IOException

Overrides:

findResources in class URLClassLoader

Throws:

IOException