org.opennms.protocols.jmx.connectors

Class IsolatingClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

org.opennms.protocols.jmx.connectors.IsolatingClassLoader

All Implemented Interfaces:

Closeable, AutoCloseable

public class IsolatingClassLoader
extends URLClassLoader

An extension of the URLClassLoader that ensures it loads specified packages rather letting the parent do it. The result is that classes loaded from these packages are isolated from other classloaders.

Author:

Mike Jamison , OpenNMS

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	IsolatingClassLoader.InvalidContextClassLoaderException

Constructor Summary

Constructors

Constructor and Description
IsolatingClassLoader(String name, URL[] classpath, ClassLoader parent, String[] isolated, boolean augmentClassPath) Constructor for IsolatingClassLoader.
IsolatingClassLoader(String name, URL[] classpath, String[] isolated, boolean augmentClassPath) Constructor for IsolatingClassLoader.

Method Summary

Methods

Modifier and Type	Method and Description
protected Class<?>	loadClass(String name, boolean resolve) Override to only check parent ClassLoader if the class name doesn't match our list of isolated classes.

Methods inherited from class java.net.URLClassLoader

addURL, close, definePackage, findClass, findResource, findResources, getPermissions, getResourceAsStream, getURLs, 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, getClassLoadingLock, getPackage, getPackages, getParent, getResource, 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, toString, wait, wait, wait

Constructor Detail

IsolatingClassLoader

public IsolatingClassLoader(String name,
                    URL[] classpath,
                    String[] isolated,
                    boolean augmentClassPath)
                     throws IsolatingClassLoader.InvalidContextClassLoaderException

Constructor for IsolatingClassLoader.

Parameters:

classpath - Where to find classes.

isolated - Array of fully qualified class names, or fully qualified prefixes ending in "*", that identify the packages or classes to isolate.

augmentClassPath - true => Add the URL's of the current thread context class loader to classpath.

name - a String object.

Throws:

IsolatingClassLoader.InvalidContextClassLoaderException - If augmentClassPath is true and the current thread context class loader is not a URLClassLoader.

IsolatingClassLoader

public IsolatingClassLoader(String name,
                    URL[] classpath,
                    ClassLoader parent,
                    String[] isolated,
                    boolean augmentClassPath)
                     throws IsolatingClassLoader.InvalidContextClassLoaderException

Constructor for IsolatingClassLoader.

Parameters:

classpath - Where to find classes.

isolated - Array of fully qualified class names, or fully qualified prefixes ending in "*", that identify the packages or classes to isolate.

augmentClassPath - true => Add the URL's of the current thread context class loader to classpath.

name - a String object.

parent - a ClassLoader object.

Throws:

IsolatingClassLoader.InvalidContextClassLoaderException - If augmentClassPath is true and the current thread context class loader is not a URLClassLoader.

Method Detail

loadClass

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

Override to only check parent ClassLoader if the class name doesn't match our list of isolated classes.

Overrides:

loadClass in class ClassLoader

Throws:

ClassNotFoundException