com.netphantom.server.utils

Class JarClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

com.netphantom.server.utils.JarClassLoader

public class JarClassLoader
extends SecureClassLoader

This class handles one Jar or several Jar file(s) (already loaded), typically NpJarFile or MemoryJarFile's.

Constructor Summary

Constructors

Constructor and Description
JarClassLoader(IJarFile jar, ClassLoader parent) Creates the Jar file class loader using the default parent class loader for delegation.

Method Summary

Methods

Modifier and Type	Method and Description
static void	addJar(JarFile jar) Adds an entry to a Jar file.
protected Class<?>	findClass(String name) Finds the class with the specified binary name.
URL	findResource(String name) Finds the resource with the given name.
Enumeration<URL>	findResources(String name) Returns an enumeration of URL objects representing all the resources with the given name.
static JarFile	getJar(String jarFileName) Gets a Jar file from an URL.
InputStream	getResourceAsStream(String name) Open for reading, a resource of the specified name from the search path used to load classes.

Methods inherited from class java.security.SecureClassLoader

defineClass, defineClass, getPermissions

Methods inherited from class java.lang.ClassLoader

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

Methods inherited from class java.lang.Object

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

Constructor Detail

JarClassLoader

public JarClassLoader(IJarFile jar,
              ClassLoader parent)
               throws IOException

Creates the Jar file class loader using the default parent class loader for delegation.

Parameters:

jar - the Jar file for the class path.

parent - the Parent class loader.

Throws:

IOException

Method Detail

addJar

public static void addJar(JarFile jar)

Adds an entry to a Jar file.

Parameters:

jar - The

getJar

public static JarFile getJar(String jarFileName)

Gets a Jar file from an URL.

Parameters:

jarFileName - The Jar file name.

Returns:

The JarFile associated with this file name or null if not found or garbage collected.

findClass

protected Class<?> findClass(String name)
                      throws ClassNotFoundException

Finds the class with the specified binary name. This method is overridden by this class loader implementations that follow the delegation model for loading classes, and will be invoked by the loadClass method after checking the parent class loader for the requested class.

Overrides:

findClass in class ClassLoader

Parameters:

name - The binary name of the class

Returns:

The resulting Class object

Throws:

ClassNotFoundException - If the class could not be found.

See Also:

ClassLoader.findClass(java.lang.String)

findResource

public URL findResource(String name)

Finds the resource with the given name. Class loader implementations should override this method to specify where to find resources.

Overrides:

findResource in class ClassLoader

Parameters:

name - The resource name

Returns:

A URL object for reading the resource, or null if the resource could not be found

findResources

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

Returns an enumeration of URL objects representing all the resources with the given name. Class loader implementations should override this method to specify where to load resources from.

Overrides:

findResources in class ClassLoader

Parameters:

name - The resource name

Returns:

An enumeration of URL objects for the resources

Throws:

IOException - If I/O errors occur

getResourceAsStream

public InputStream getResourceAsStream(String name)

Open for reading, a resource of the specified name from the search path used to load classes. This method locates the resource through the system class loader (see getSystemClassLoader()).

Overrides:

getResourceAsStream in class ClassLoader

Parameters:

name - the name of the resource.

Returns:

An input stream for reading the resource, or null if the resource could not be found.

See Also:

ClassLoader.getResourceAsStream(java.lang.String)