Package com.sun.istack.tools

Class ParallelWorldClassLoader

java.lang.Object

java.lang.ClassLoader

com.sun.istack.tools.ParallelWorldClassLoader

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class ParallelWorldClassLoader
extends java.lang.ClassLoader
implements java.io.Closeable

Load classes/resources from a side folder, so that classes of the same package can live in a single jar file.

For example, with the following jar file:

  /
  +- foo
     +- X.class
  +- bar
     +- X.class
 

ParallelWorldClassLoader("foo/") would load X.class from /foo/X.class (note that X is defined in the root package, not foo.X.

This can be combined with MaskingClassLoader to mask classes which are loaded by the parent class loader so that the child class loader classes living in different folders are loaded before the parent class loader loads classes living the jar file publicly visible For example, with the following jar file:

  /
  +- foo
     +- X.class
  +- bar
     +-foo
        +- X.class
 

ParallelWorldClassLoader(MaskingClassLoader.class.getClassLoader()) would load foo.X.class from /bar/foo.X.class not the foo.X.class in the publicly visible place in the jar file, thus masking the parent classLoader from loading the class from foo.X.class (note that X is defined in the package foo, not bar.foo.X.

Author:

Kohsuke Kawaguchi

Constructor Summary

Constructors

Constructor	Description
ParallelWorldClassLoader(java.lang.ClassLoader parent, java.lang.String prefix)

Method Summary

Modifier and Type	Method	Description
void	close()
protected java.lang.Class	findClass(java.lang.String name)
protected java.net.URL	findResource(java.lang.String name)
protected java.util.Enumeration<java.net.URL>	findResources(java.lang.String name)
static java.net.URL	toJarUrl(java.net.URL res)	Given the URL inside jar, returns the URL to the jar itself.

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findClass, findLibrary, findLoadedClass, findResource, findSystemClass, getClassLoadingLock, getDefinedPackage, getDefinedPackages, getName, getPackage, getPackages, getParent, getPlatformClassLoader, getResource, getResourceAsStream, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, getUnnamedModule, isRegisteredAsParallelCapable, loadClass, loadClass, registerAsParallelCapable, resolveClass, resources, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

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

Constructor Detail

ParallelWorldClassLoader

public ParallelWorldClassLoader(java.lang.ClassLoader parent,
                                java.lang.String prefix)

Method Detail

findClass

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

Overrides:

findClass in class java.lang.ClassLoader

Throws:

java.lang.ClassNotFoundException

findResource

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

Overrides:

findResource in class java.lang.ClassLoader

findResources

protected java.util.Enumeration<java.net.URL> findResources(java.lang.String name)
                                                     throws java.io.IOException

Overrides:

findResources in class java.lang.ClassLoader

Throws:

java.io.IOException

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Throws:

java.io.IOException

toJarUrl

public static java.net.URL toJarUrl(java.net.URL res)
                             throws java.lang.ClassNotFoundException,
                                    java.net.MalformedURLException

Given the URL inside jar, returns the URL to the jar itself.

Throws:

java.lang.ClassNotFoundException

java.net.MalformedURLException